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Access API 


Access API is a software option for Eicon Technology’s Access com- 
munications programs. It defines an interface through which third 
party applications can manipulate the Access program to perform 
sophisticated communication functions. These functions allow 
developers and users to take advantage of Eicon Technology 
hardware and software solutions for micro-to-mainframe connec- 
tivity. 

Access API supports the full range of Access terminal emulations 
under TTY, 3270 and 5250 communications. In addition, the API 
interface for 3270 and 5250 provides support for a variety of third 
party software. 


For 3270 users, Access API is compatible with the IBM PC 3270 
Emulation Program Presentation Space API and the IBM PC 3270 
Entry Emulator High-Level Language API. It also supports IBM 
Personal Services/PC, PROFS PC and GDDM-PCLK. 


In 5250 setups, Access API provides the facilities for running IBM PC 
Support/36 and PC Support/38 software. 


Access API is available in both stand-alone and LAN versions for the 
folowing Eicon Technology software: Access/X.25, Access/QLLC 
and Access/SDLC. 
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API stands for Application Program Interface. As the name suggests, 
an API defines the interface into an application program. It is the 
entry point which allows other programs to manipulate an applica- 
tion program the same way a user might. 


APIs help facilitate the automation and customization of application 
functions. Tedious procedures that need to be performed repetitively 
by the user, such as logging on to several host computers each 
murinpy, can be done quickly with an APFi routine. 


Access API allows your application programs to request 3270, 5250 
or TTY communication services from Access application software. 
These services include most of the functions available to users of the 
Access program, such as: placing calls, receiving calls, file transfers, 
management of multiple sessions, and various terminal emulations. 


The Access API interface lets you customize your communications 
setup by installing your own programs between local users and 
outside host computers, or it will allow you to extend your current 
applications into the X.25 or SNA communication environment. 


Access API is extremely flexible. Talk directly to the API interface in 
assembler, in most high level languages, or from the DOS command 
line and DOS batch files. 


Access API offers more than just a programming interface. It was 
designed to be compatible with certain IBM protocols in the 3270 
and 5250 environments. This means you can combine third party 
applications with the power of Eicon Technology gateways. 


The Access API option for 3270 defines two interfaces. The first is 
functionally identical to the IBM 3270 Emulation Program (version 
3.11), and provides support for IBM Personal Services/PC, GDDM- 
PCLK and IBM PROFS PC, as well as Tempus-Link and Tempus- 
Share from Micro Tempus. The second is functionally identical to the 
IBM PC 3270 Entry Emulator High-Level Language API (EEHLLAP]). 
Both interfaces allow users to run their current applications over 
Eicon Technology gateways with no modifications to their code. 


For 5250 environments, Access API sports an interface for the IBM 
PC Support/3X programs that is functionally equivalent to the IBM 
5250 Remote Emulation program. 


And finally, since Access API is an option to Access communication 
software, users can still take full advantage of the Access program 
interactively. 


Overview 


What is an API? 


What does 
Access API! 
allow me to do? 


Access API Reference Manual 


What do | need 


to know fo use 
Access API? 


Many of the API function calls in this manual are similar to com- 
mands available to users of Access Application software. To make 
effective use of these functions you should be familiar with the 
operation of the Access program, and the specifics of the communica- 
tions options you will be using (VT100, 3270 or 5250). 


Use of the API interface requires an understanding of MS-DOS batch 
file conventions and 8088 Assembly Language, or any other language 
that provides access to the PC’s registers (such as ’C’). 


Po 


Conventions 


This manual is intended to be a programmer's reference to Access 
API, and as such it will not cover information that is already available 
elsewhere. However, this manual contains references to other 
documentation which may prove useful. They take the form: 


Eas This Manual - Appendix D: Reference Books 


The term EiconCard is used to denote any of Eicon Technology's 
communications controller cards, including: Network Adapter, Dial 
Network Adapter, Single-Port Communications Coprocessor, Dual- 
Port Network Adapter, EiconCard, and EiconCard HSI. 


All numbers in this manual are in decimal unless followed by the 
suffix ‘h’, which denotes hexadecimal. 


Any command that is entered at the DOS prompt is represented as 
follows: 


Command Line Conventions 


GETSCR The name of the command. You can 
type this in upper or lower case it does 
not matter. 


Items capitalized and in bold type must 
be entered as shown. 


Items in lowercase italic type are user 
supplied input. You should replace 
these items with the values you need. 


[ITEM] Items enclosed by a pair of square 
brackets are considered optional. You 
can either include them or not. Do not 
type the brackets. 


{THIS|THAT} A vertical line separating two or more 
items enclosed in braces means make a 
choice. Enter one of the items when you 
use the command. Do not type the ver- 
tical line or the braces. 


References 


EiconCard 


Numbers 


Input 


How Access API Works 


The Big Picture 


The API 
Translation 
Programs 


Access and the 


API Option 


The NABIOS 


Soffware 


The Access API communications program works in conjunction with 
Access software, an EiconCard and its communications software, 
and your Local Area Network (LAN). 


When you install Access API, it attaches itself to the Access applica- 
tion software that resides on your PC. This expands the Access 
program so it can communicate with other applications. The diagram 
on the next page illustrates how different programs use the API 
interface to talk to Access, and how the Access gateway carries out 
their communications requests. The following paragraphs describe 
each step in detail. 


API5250, IBMAPI and EEHLLAPI are translation programs that come 
with the Access API package. They allow programs that conform to 
certain specifications used by IBM in the 3270 and 5250 environ- 
ments to run without modification on Eicon Technology gateway 
products. This includes various third-party software, as well as IBM 
and user developed applications. 


IBMAPI and EEHLLAPI mimic interfaces defined by IBM. They accept 
IBM calls from third-party applications, translate them into Access 
API commands and pass them to the Access program through the 
API interface. 


API5250 defines an interface that accepts calls from the PC Sup- 
port/36 and PC Support/38 programs. It translates these calls and 
passes them to Access for execution. 


When third party application programs request communication ser- 
vices from Access, all data is passed to and from Access through an 
assembler level interface. This is true for DOS batch files, high level 
language requests and the IBMAPI translator program. 


The API option gives Access the ability to manage this interface. It 
transfers data to and from third party applications and determines 
whether input data (API requests) are valid. Some requests are 
handled internally by the Access program, while others require the 
use of the EiconCard. The latter reach their destination via the 
NABIOS and LAN software. 


NABIOS is a memory resident program. It manages the link between 
the Access API program and the EiconCard installed in your PC or 
on the network gateway. 
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Versatile Interface 


Access API permits a wide range of different 
applications to communicate over an Eicon 
Technology gateway. Each application talks 
to specifically designed emulations, which In 
furn talk fo Access API 
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How Access API! Works 


Access API passes commands down to the NABIOS, which in turn 
routes them to the appropriate software module on the EiconCard. 
In a stand-alone PC this is straightforward — data is passed on the 
PC’s bus directly to the card. In a LAN environment, the EiconCard 
will most likely be located in another PC (designated as the com- 
munications server or gateway PC). NABIOS on the local PC (or 
redirector) uses the services of the LAN software to transport data to 
the gateway PC. NABIOS on the gateway PC then passes this data to 
the correct module on the EiconCard. Data is returned from the 
gateway in the same manner. a 


NABIOS is provided on a diskette that comes with Access Application 
software. It is not part of the API package. 


LAN software is the carrier for all data on a local area network. It 
picks up data from the computers on the LAN, identifies the destina- 
tion addresses and delivers the information to the proper locations. 
Access works with all NetBIOS compatible LAN software. Eicon 
Technology does not sell this software. It is available from a variety 
of vendors, including: IBM, Novell, 3Com, Banyan and Ungermann- 
Bass. Eiisr Access/X.25 User’s Guide - Appendix H 


Your EiconCard will contain the software modules that are particular 
to the communications protocols you are using. Each module is 
responsible for a specific protocol, be it SNA or X.25, and does all 


work when data is transmitted or received by the gateway. NABIOS 
talks directly to the module that will handle the communications task 


at hand. 


The communications modules are loaded into the memory of the 
EiconCard by a control program (K25NET, SDLC, SNA). Both the 
communications modules and the control program are part of the 
Access Application Software package and are not supplied on the 
Access API diskette(s). | 


The EiconCard is the root of the Access gateway. It is an intelligent 
communications adapter card for the IBM PC or PS/2 family of 
computers. It has its own on-board processor (Motorola 68008) and 
memory, and comes with different external interface options to 
connect with outside lines. | 


The EiconCard handles all processing of communications protocols 
leaving the host PC free to perform other tasks. 
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Information flow between Workstation running IBM PC Support/36 


the Workstation and the 


Communications Server on top of Access API 
and Access/QLLC (5250 support) 


5250API.EXE 


a ‘Access API 
he seas 
| I. 2 il t 


“LAN Software 
NABIOS SRV : 


[ || Communications Server running Access API 
S=_ and Access/QLLC (5250 support) 


EiconCard 


| EiconCard Software 


X.25 link 


Access API allows you to create custom 
7 connectivity solutions that can span multiple 
host destinations using X.25. 


pi 
~-/_~ 

C X.25 

* ( Packet-Switched —#A 

Network 

c. ae —) 


i 


Public Databases 
Bulletin Boards 


rrnletaintalatatatatstabstatcentitnte stants ate hed 


cig 


IBM Mainframe with NPSI or DSP Front End 


Installing Access API 


File List 


Package 
3270, 5250, X.25 


3270, 5250, X.25 
3270, 5250, X.25 
3270, 5250, X.25 
3270, 5250, X.25 
3270, 5250, X.25 
3270, 5250, X.25 


3270 
3270 
3270 
3270 


5250 
5250 


5250 


Access API is available in three different options: 3270, 5250 or X.25. 
Depending on the option, different files will be present on the API 
diskette(s) you receive. 


Access API Files 


Filename 
INSTALL.EXE 


ACCESS.EXE 
ACCCFG.EXE 
ACCESS.CFG 
ACCESS.FMX 
EXECUTE 
SOURCE 


IBMAPI.EXE 
SEND.EXE 
RECEIVE.EXE 
EEHLLAPI.EXE 


API5250.COM 
INTRTR.EXE 


DISKS3X.EXE 


Description 


Installation Program 

Access API Program 

Configuration Program 

Configuration Datafile 

Screen Format File 

Directory containing Executable DOS Files 


Directory containing Source Code 


IBM/Ejicon Technology API translator 
Emulates the PS/PC Send program 
Emulates the PS/PC Receive program 


IBM/Eicon Technology API translator 


IBM/Eicon Technology API translator 


Used to interrupt the PC Support/3X router 
program 


Used to download PC Support/3X 


The Access API program comes on a single 3.5" diskette for PS/2 
machines, or up to three double density 5.25" diskettes for XT and 
AT computers. The diskette labelled Programming Examples contains 
the EXECUTE and SOURCE subdirectories. 
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The INSTALL program will help you set up the API software. In LAN 
environments you should install the API software on the server 
(gateway) PC and each PC that will be making API calls. The proce- 
dure is as follows: 


Insert the API disk (or the disk labelled 1 if you have two) into disk 
drive A: and enter the INSTALL command at the DOS prompt. If you 
have two disks, perform the INSTALL commmand on each one. 


Install Command 


A:INSTALL drive-name subdirectory-name 


drive-name identifies the disk where your Access 


application software is currently in- 
Stalled. 


subdirectory-name _ is the full path name of the subdirectory 


For example the command: INSTALL C: \Access installs the Access 
API option on the Access software located on drive C: in sub-directory 
\Access. 


The INSTALL program only installs the API option onto the Access 
program. It will not install any files from the EXECUTE or SOURCE 
subdirectories, nor will it install the following programs: 


IBMAPI.EXE 
SEND.EXE 
RECEIVE.EXE 
EEHLLAPI.EXE 
API5250.COM 
INTRTR.EXE 
DISKS3X.EXE 


You should copy these files to the proper directories when you need 
them. Efis> This Manual - 3270 Applications or 5250 Applications 


Once INSTALL has finished copying files it will present a new version 
of the controller card General Configuration Menu. This new menu 
is identical to the standard Access menu ( BQ™ES> Access /X.25 
User's Guide - Specifying Access Configuration) except for one addi- 
tion - a sub-menu under function key F2 which allows you to 
configure the API software interrupt. 


Installation 
Procedure 


Configuration 
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Installing Access API 


INSTALL copies all configuration information from your previous 
version of the Access Application software into the new menu. You 
will not have to redo the settings for any of the Configuration Menus. 


Access AP! Software Interrupt 


The default setting for the software interrupt is 7Bh. This can be 
altered within the range 40h to FFh by reconfiguring the Access 
program with the ACCESS CONFIG command. 


It is not a good idea to set the software interrupt to a value used by 
other programs. So if you are running any software that already 
makes use of interrupt 7Bh, change the setting. 


Known Software Interrupts 


Interrupt Value (Hex) software Product 
5C NetBIOS 


7A IBMAPI 


hes Executable DOS files 

If you change the setting of the software interrupt, you must include 
the /Interrupt parameter each time you use an executable DOS file. 
This will ensure that the new interrupt is used _for API requests. 


Alternate Tasks 


In order for the API interface to operate properly you should set 
Enable Alternate Tasks to “Y” in the General Configuration Menu of 
the Access program. 


Gracy PC Support/3X and the Access Hot Key 

If you are planning to use IBM PC Support/3X software with Access 
API you should reconfigure the Hot Key ( Eger Access/X.25 User’s 
Guide - Specifying Access Configuration). This is necessary because 
the default setting, ALT-ESC, is used by the PC Support software. If 
you enter ALT-ESC by accident or you keep it as the "Alternate Task 
Key, "it willlock the keyboard. Enter ALT-ESC again and the keyboard 
will be unlocked. 


(ot 


32/0 Applications 


Access API (3270 Support) allows you to run any program that is 
compatible with the API defined by IBM for its 3270 Emulation 
Program Version 3.11, or its Personal Computer 3270 Entry 
Emulator High-Level Language Version 1.21. 


In order to APIs, Access API requires the translation programs 
IBMAPI.EXE and EEHLLAPI.EXE. These programs convert IBM API 
and IBM EEHLLAPI calls into Access API calls. 

Iiass iGMAPI and EEHLLAFI 

Before you make use of IBMAPILEXE or EEHLLAPI.EXE you will have 


to copy them to your working directory from the Access API diskette. 
The INSTALL program does not install them. 


Running applications compatible with the IBM 3270 Emulation 
Program with Access API is easy. First run IBMAPI.EXE by typing 
the following command at the DOS prompt: 


IBMAPI 


Next, start the Access program and make a 3270 call to your host. 
Depending on the type of IBM API application you will be running, 
you may have to perform other functions (such as logging onto the 
host). Once this is done, use the Hot Key or the F4 DOS key to return 
to DOS. You can now run any application that makes IBM API calls. 


Gc Running Personal Services /PC 

SEND.EXE and RECEIVE.EXE allow you to run the IBM Personal 
Services/PC program. In order for PS/PC to function properly, you 
must copy SEND.EXE and RECEIVE.EXE into the subdirectory where 
the PS/PC program is instalied. Once this is done you can follow the 
steps outlined above. 


Running any IBM EEHLLAPI compatible programs with Access is 
extremely simple. First, execute EEHLLAPI.EXE by typing the follow- 
ing command at the DOS prompt: 


EEHLLAPI 


Next, start the Access program and use the F4 DOS key to return to 
DOS. Now you can run any EHHLAPPI application and it will use the 
Access gateway. 


Bec EEHLLAPI Programs 
For a complete definition of EEHLLAPI, see IBM document 74X9879, 
IBM PC 3270 Emulation Program Entry Level Programmer’s Guide. 


Starting Up 


IBMAPI 


Starting Up 


EEHLLAPI 
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5250 Applications 


Downloading 


PC Support/3Xx 
Soffware 


Starting Up 


PC Support/3xX 


}2 


Access API (5250 Support) allows you to run the IBM PC Support/36 
(version 4.0) and PC Support/38 (version 2.0) programs. To do this 
you will have to make some minor adjustments to certain procedures 
in your IBM manuals. 


If you are downloading the PC Support software from a System/3X 
host, you will need to make some modifications to the directions given 
in the PC Support/3X Technical Reference manual. The easiest way 
to look at things is as follows: Running API5250, ACCESS and 
DISKS8X is equivalent to running the IBM Remote Emulation Program 
with the /s parameter. So where the PC Support/3X manual men- 


tions the loading of the Remote Emulation Program, substitute the 


following: 

z+ Run API5250 

=> Run the Access program 

z+ Call a 5250 session then Hot Key to DOS 
> 


run DISKS3X s 
Where s is the name of the selected drive. 


baie Downloading 
The recommended drive value for s is A. It is complicated to use values 
above C, since the PC’s internal switches must be set properly. 


Downloading the files in this manner is very slow (1-6 hours). Once 
the virtual disk software has been downloaded, you can speed things 
up by using it to download the rest. 


Once again, the easiest way to look at things is as follows: Running 
API5250 and ACCESS is equivalent to running the IBM Remote 
Emulation Program. So to start PC Support: 


=> Run API5250 
=» Run the Access program 
z+ Call a 5250 session then Hot Key to DOS 


z+ For PC Support/38, run STARTRTR 
For PC Support/36, run BEGINRTR 


mt 
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Access API Programmer's Reference 


Use the following in place of “Interrupting the Router” as described 
in the PC Support/36 and PC Support/38 Technical Reference 
manuals. 


To temporarily interrupt the router, use the INTRTR.EXE program 
supplied on the Access API diskette(s) as follows: 


At the DOS prompt, type: 


INTRTR 36 (for PC Suppori/ 36) 
or 


INTRTR 38 (for PC Support/38) 


Depending on the type of computer you are connecting to, a host 
menu will be displayed on your router session screen. For a System / 
36, this menu is the INQUIRY OPTIONS menu. For a System/38 it 
will be the SYSTEM REQUEST menu. On either, select option 1 
("Request Command display" on a 36, "Transfer to a secondary 
inactive job" on a 38). You will now be able to use your PC as a 5250 
display station. 


The last action performed by INTRTR is to activate the Access 
program. Therefore it is possible to put your 5250 session on hold 
and use the other functions of the Access software. The only restric- 
tion is that you should not hang up the router session. 


To restart the router on a System/36, press the emulated command 
key 1. On a System/38, sign off the secondary interactive job. Both 
actions will cause the "router screen" to appear. You can now use the 
Access Hot Key or F4 DOS to return to DOS. It is recommended that 
you Hot Key to DOS from this screen only. If for some reason the 
router screen does not appear, the Hot Key will still take you back to 
DOS. However, this should be used as an emergency exit only. 
Unpredictable results will occur if you do not return to DOS through 
the router screen. 


Rees Using Virtual Disk or Virtual Printer 

When using virtual disk or virtual printer, Access will temporarily stop 
processing data intended for other sessions. This is because DOS is 
not re-entrant. If the other session is a display or printer on the same 
controller (PU), this could cause the X25 or SDLC window to fill up. If 
this happens, all communication for that controller will block. There is 
no recovery except to restart the PU. The router program may not 
recover from this, and the PC may have to be restarted as well. 
Therefore it is strongly advised not to have multiple sessions (especial- 
ly printers) on a PC which is using virtual disk or printer. 


Interrupting the 


Router 


Restarting the 


Router 
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API Programming 


The Assembler 


Level interface 


The Executable 


DOS Files 


Access API allows you to manipulate the Access program in two 
different ways: from an assembler interface, or through commands 
typed at the DOS prompt. 


The Assembler Level Interface is at the root of the Access API system. 
All communication with third-party applications occurs here. 


The Assembler Interface consists of a number of different functions. 
Each function is identified by a unique Service Number. To invoke 
an API function, you load register AH with the Service Number and 
supply the necessary data in the Pc’s other registers. Next you issue 
a software interrupt. This activates an Access API routine which 
processes the function request. Any output from the function call is 
returned in the Pc’s registers. 


A complete description of each Access API function call is presented 
under Access API Function Calls starting on page 21 of this manual. 


Assembler Functions 


Control Control functions are used to manage 
the API interface and the Access pro- 
gram. 


Session These functions operate across all com- 
munication sessions: 3270, 5250 or 
TTY. They allow you to establish and 
manipulate the connections. 


3270, 5250, TTY These three sets of functions are specific 
to particular types of sessions. They give 
you control over file transfers, cursor 
positioning, and various emulation- 
specific features. The presence of each 
group of these functions is dependant on 
the Access API option you are using. 


The Executable DOS files allow users to manipulate Access from the 
DOS command line or through batch files. They provide nearly all 
the functionality of the Assembler Interface, although certain as- 
sembler commands are now options rather than stand-alone func- 
tions. 


To invoke API functions from the DOS prompt or from within DOS 
batch files you simply enter the name of the function followed by the 
correct parameters. 


mare 


Access API Programmer's Reference 


Each Executable DOS file returns a value upon completion. These 
values let you know if the function completed successfully or en- 
countered an error. You can make use of these values in batch files 
by using the DOS ERRORLEVEL command. 

Eas This Manual — Appendix C 


A complete description of each Executable DOS file is presented 
under Executable DOS Files starting on page 75 of this manual. 


The API Software Interrupt 


The Executable DOS files have been coded to use the default software 
interrupt 7Bh. If you have changed the interrupt, you must use the 
/{=Interrupt flag (where Interrupt is the hexadecimal number of the 
new interrupt setting) with each call to indicate the value of the new 
interrupt setting. 


The Executable files are located in the EXECUTE subdirectory on the 
API diskette(s). They were created using the Microsoft C Compiler. 
The C code for each of the modules is located in the SOURCE 
directory. You can study and modify these files to suit your own 
needs. 

Eegs> This Manual — Appendix B 


To activate the Applications Program Interface, start the Access 
program and use the Hot Key or the F4 DOS key to put it into the 
background. When you are back on the DOS command line you can 
run your API application, or make use of the Executable DOS 
commands. 


The Assembler Level Interface 


To activate the interface your first call must be Service 00: Open API 
Interface. Access API will respond with an error message to all other 
functions until this call is issued. 


The Executable DOS Files 


Each of these files takes care of opening the API Interface before it 
executes. There is no special start up procedure. 


Starting Up 


fhe API 


1S 
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Closing Down 


fhe API 


API Programming 


Shutting down involves three steps: closing the API interface, ter- 
minating your application, and terminating Access API. 


The Assembler Level Interface 


Close the Access API interface with Service 14: Close API Interface. 
This will re-enable the user hot key and allow the user to switch into 
Access and also shut it down. 


As long as the API interface is open, the Access API program cannot 
be terminated. Any attempt to do so will produce the error message 
"API Active, Cannot Exit". 


Executable DOS Files 


Each Executable file closes the API interface when it terminates. The 
API interface is only open for the time it takes the command to run. 
However, in cases where a function is aborted during execution, you 
should run ENDAPI.EXE. This will make sure the API interface is 
correctly closed. 


Mayas Terminating Access 


Access cannot be terminated if another program is active above it in - 


memory. This is done to prevent DOS from crashing. 

Access API is a memory resident program. When it terminates, it frees 
up all the memory it was using. If there is a programabove it in memory 
(a program loaded after Access) a hole will be left in the PC’s memory 
space. When DOS runs into this hole, it crashes the system. 


If you cannot terminate all your applications before shutting down 


Access, then load them before you load Access. 


Pats mote! 


Access API! Nuts & Bolts 


Access API treats the PC’s registers as follows: 


Value not preserved ax, bx, cx, dx, di 
Value preserved cs, ds, Ss, sp, es, bp, si sp 


Certain registers perform similar roles across most of the API func- 
tions. 


Input 

Register Function 
AH service number of the API Function 
AL flags interpreted by the function 
BX session id 

CX  —s length of input string/buffer or 
keystroke id number 
CL field number byte 
ES segment of input/output buffer/string 
DI offset of input/output buffer /string 
DX offset into device buffer 
DL column 
DH row 
Output 

Register Function 
AL return code 
BX session id 
DX offset into device buffer 
DL column 
DH row 
CL character or field number 
CH attribute or number of input fields 
CX status word 


Registers 
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Memory 
Requirements 


Screen Buffers 


Access AP! Nuts & Bolts 


Access is a memory resident program, therefore it reserves all the 
memory it requires for proper operation at load time. Each session 
you define under ACCESS CONFIG will add to the amount of memory 
ACC€éSS reserves. 


You can get a good idea of how much memory Access requires by 
using the following table. Total up the memory for each configured 
emulation and add this to the size of the ACCESS.EXE file. 


Memory Requirements (Kbytes) 


Emulation Standard Extended 


ITI or VT100 


3278, 3279 Model 2 
3278, 3279 Model 3 
3278 Model 4 
3278 Model 5 
3270 printers 
5250 (all models) 


5250 printer 10 


Extended refers to sessions with extended color or high-lighting 
enabled. If Program Symbols are enabled add 25.5K bytes. 


Access API keeps a separate buffer for each active session. This buffer 
reflects the appearance of the session screen. If the session is active 
in the foreground with screen updates enabled, then any character 
placed into this buffer will appear on the screen. If the session is in 
the background, then only the buffer is updated. These buffers 
enable you to have multiple sessions active without losing data. 


API function calls allow you to operate directly on these buffers, so 
it is important to know their structure. Character positions are 
referred to by offset, with line 1 on the screen having character 
positions from offset O to 79. Line 2 follows with offsets from 80 to 
159, and so on. 


frescss Cursor Positions 
Cursor positions are referred to by row and column numbers rather 
than offset. | 


adelante 


Access API Programmer's Reference 


There are three types of Screen buffers: 


32/70 Buffer 


This buffer contains an image of the 3270 screen. Characters and 
Attributes are stored in Device Buffer Format. 

Eas: IBM PC 3270 Emulation Program User’s Guide — Appendix A 
(Character Code Table) 


3270 Buffer 


Terminal Rows Columns Coordinates 


3278 Model 2 24 00 to 1919 
3278 Model 3 32 00 to 2559 


3278 Model 4 43 00 to 3439 
3278 Model 5 27 00 to 2559 
3279 Model 2 24 00 to 1919 
3279 Model 3 32 00 to 2559 


5250 Buffer 


This buffer contains an image of the 5250 screen. Characters and 
Attributes are stored in EBCDIC format. 


5250 Buffer 


Terminal Rows Columns Coordinates 
5251 Model 11 24 to 1919 
5251 Model 12 24 to 1919 
5291 Model 1 24 to 1919 
5291 Model 2 24 to 1919 
5292 Model 1 24 to 1919 
3180 21 to 2559 


ITY Buffer 


This buffer contains an image of an ITI or VT100 screen. All charac- 
ters are stored in ASCII format, one character per byte. 


TTY Buffer 


Terminal Rows Columns Coordinates 


VT100 24 80 00 to 1919 
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Access AP! Nuts & Bolts 


Display 
Adapters 


Device Drivers 


The Access program is aware of the type of display adapter that is 
installed in a system, be it CGA, EGA, VGA or monochrome. If the 
program is being used interactively by a user, video modes are saved 
and restored when the user Hot Keys out of Access into DOS or 
another application. When manipulating sessions with Access API 
function calls the responsibility for setting the screen mode rests with 
the programmer. When a session is brought to the foreground with 
an API function call, it is assumed that the correct video mode is 
active. Garbage will result on the screen if the programmer has not 
set the display to match the requirements of the session. 


If an application program is installed as a DOS Device Driver or is 
running in the background (activated from an interrupt), then certain 
restrictions are placed on what it can do. 


=+ only one Access session can be active at any one time. Attempts 
to open more than one session will result in communications 
being blocked. 


z+ the API interface must be opened each time the driver is called 
and closed before the driver returns. This means using Service 
OOh: Open API Interface at the start of your driver, and Service 
14h: Close API Interface at the end. 


z+ the driver may not initiate a session with Service 01: Call or 
Service 17h: Answer. 


§ 


it is prohibited to use Service 13h: Hot Key Switch to give control 
to the user or to access a session that already has a file transfer 
operation in progress. | 


z+ it is also prohibited to use any API functions that will result in 
Access API making DOS function calls. This includes: 


3270 Functions Service 12h: File Transfer 
Service 15h: Save Screen 


5250 Functions Service 3Dh: Save Screen 


TTY Functions Service 1Dh: File Transfer 
Service 1Eh: File Capture 


The following section presents a detailed description of each of the 
Access API assembly language function calls. 


There are 48 Access API function calls. Each function is classified in 
one of five divisions: Control Function, Session Function, 3270 


Function, 5250 Function or TTY Function. Control and Session | 


AAP ~™ ~- oe ~! t rrwrve 


funclions Car ve used wiih any iype of session. 3270, 5250 and TTY 
functions are specific to their respective session types. 


Access API Function Calls 


Divisions 


2 | 
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Service 14h: Close API Inierface Contro/ Function 


Input 


Output 


Description 


Note 


AH = 14h 
AL = 00 


none 


This function ends API activity and reenables the user Hot Key. If 
Close API Interface is omitted, the ability to bring up Access through 
the user Hot Key will be lost. In this case, to return to Access the 
user should type EXIT at the DOS prompt. 


This function does not terminate the Access program. Access and 
any active sessions will still be available for use. 


service 13h: Hot Key Switch 


Input 


Description 


Note 


Control Function 


AH 
AL 


13h 
type of switch OOh — regular mode 
O1h — enhanced mode 


ES:DI = address of the Key List (enhanced mode only) 


AX = Exil Key 


This service causes the calling application to be suspended and 
activates the Access program in interactive mode. The current 
foreground session is displayed with keyboard input and screen 
updates enabled. 


Regular Mode 


If the user attempts to exit from Access using F10 QUIT, the message 
“API Active, Cannot Exit” is displayed. All other Access functions can 
be executed. Control is returned to the application only when the 
user Strikes the F4 DOS key. 


Enhanced Mode 


This mode allows the calling application to put restrictions on exactly 
what a user can do when placed back into Access. Enchanced Mode 
disables all Access function keys not specific to an emulation. This 
includes F1 Directory, F2 Call, F3 Answer, F4 DOS F6 Switch, F10 
Exit. In addition, wherever the F4 DOS (or ALT-ESC hotkey) was 
active, Access now checks each user keystroke against the Key List 
for a match. If a match is found Access returns to DOS with the DOS 
ScanCode value of this key as Exit Key. 


Key List 


Description 
Number of ScanCodes in the Key List 


2 bytes for the ScanCode of each key 


This function will only work if “Enable Alternate Tasks” is set to “Y” 
under ACCESS CONFIG. If set to "N" this function will execute but 
nothing will happen. Also, since actual ScanCodes are used a conflict 
with a configured key is possible. This function takes precedence. 
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Service 00h: Open API Interface Control Function 


Input 


Output 


Description 


AH = 00h 
AL = 00 


AL = Return Code OOh — successful 


This function must be the first API call issued. It activates the API 
interface and disables the user Hot Key (ALT - ESC) for the duration 
of API activity (Assembler Service 13h: Hot Key Switch is the only 
exception to this). Access screen updates are suspended for any 
active sessions. 


ne 


HW 


r( Service OFh: Query Access Type Control Function 
i Input AH = OFh 
: AL = 00 
Output CX = Access software Option ID 
DX = Access software Version Number 
1 
if Description This function allows an application to determine the Option ID and 
7 the Version Number of the Access software it has contacted. 

i: Access Software Option ID 

QLLC 102 

SDLC 106 
T X25 101 
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service 17h: Answer > SessionFunction ~~ 
A 
Input AH = 17h 
AL = 00 
AL = Mode OOh — answer by name 
O1h — answer by values 
CX = length of Answer Data in bytes 
ES:DI = address of Answer Data 
Output AH = Return Code OOh — successful 
01h — name not found or invalid call values — 
O2h — unsuccessful 
BX = Session ID if successful — 
Description This function sets up an ITI answer session. It returns a Session ID 
immediately without waiting for completion of the connection. Use 
service 11; Query Session Status to determine when the incoming call 
has connected. ae 
This function is for ITI session only. It operates in two modes. _— 


Answer by Name 


In this mode, Access API tries to match the character string supplied 
as Answer Data with the names in the current Access Calling 
Directory. If a match is found (the match operation is not case 
sensitive), Access creates an Answer session using the parameters 
for the entry. 


Answer by Values 


In this mode, an answer session can be created without refering to 
an Access Calling Directory entry. Instead of containing a Calling 
Directory Name, Answer Data should contain a series of fields that 
define the parameters of such an entry. Each field contains three 
items: a Field Identifier byte, a Field Length byte and Field Data. 


Field Identifiers are codes that represent Access Calling Directory 
parameters. A list of Field Identifiers is presented on the next page. 


Field Length is the length of the Field Data in bytes. 
Field Data is a string of characters. 


The first word of the Answer Data buffer must contain the total length 
of the Answer Data buffer. This should be followed by fields for Call 
Name and Call Type respectively. Additional fields can be specified 
in any order. 


fo 
| 


ace 


Value 
8th 


82h 
83h 
84h 
85h 
86h 
87h 
88h 
89h 
8Ah 


Example 


Service 17h: Answer (continued) 


Field Identifiers 


Field Name 
Call Name 


Call Type 

DTFE Address 
Facilities 

Call User Data 
Parameters 
PU Name 

LU Number 
Printer Model 


Printer Destination 


The following example creates an answer session called “Anyone” 


using the Call by Values option. It will connect with a call from any 


DTE address. 


Answer Example 


Contents Description 
Total length of Call Data 


Field ID for Call Name 
Length of Call Name 
Call Name 
Field ID for Call Type 
Length of Call Type 
Call Type 

_ Field ID for DTE Address 
Length of DTE Address 


DTE Address (accept all) 


2/ 
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Input AH = 04h 
AL = Screen Update Flag O0Oh — background 
O1h — hold (TTY only) 
BX = Session Id 


Ou {put AL = Return Code OOh — successful 
01h — invalid session id 


Description This service places the session with the specified Session ID into the 


background and stops all screen updates. For TTY type sessions (ITI, 
VT-100) the session may be put on Hold instead into the background. 


mm 
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Service O7h: Call Session Function 
Input AH = Oth 
AL = Mode OOh — call by name 


Oufpuf 


Description 


O1h — call by values 
CX = length of Call Data in bytes 


ES:DI = address of Call Data 


AH = Return Code OOh — successful 
Oih — name not found or invalid call values 
O2h — call failed 


BX = Session ID if call is successful 
BH = X.25 Cause Code if call fails 
BL = X.25 Diagnostic Code if call fails 


This function establishes a 3270, 5250 or ITI connection. It operates 
in two modes. 


Call by Name 


In this mode, Access API tries to match the character string supplied 
as Call Data with the names in the current Access Calling Directory. 
Ifa match is found (the match operation is not case sensitive), Access 
API will try to make the call using the parameters for the found entry. 
If the call is successful then a Session ID is returned and the session 
is placed in the background. 


If the Call Name is that of an Autolog (.ALG) file, the file will be opened 
and executed exactly as if it were run under Access. Depending on 
the instructions in the Autolog file this might lead to screen updates 
being enabled and messages being written to the display. 


EGue<sAccess/X.25 User’s Guide — Chapter 10: Autostart & Autolog 
Features 


Cail by Values 


In this mode, a call can be made without refering to an Access Calling 
Directory entry. Instead of providing a call name, Call Data should 
contain a series of fields that define the parameters of a call. Each 
field contains three items: a Field Identifier byte, a Field Length byte 
and Field Data. 


Field Identifiers are codes that represent Access Calling Directory 
parameters. A list of Field Identifiers is presented on the next page. 


Field Length is the length in bytes of the Field Data. 


Field Data is a string of characters. 
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Service 01h: Call (continued) 


The first word of the Call Data buffer must contain the total length 
of the Call Data buffer. This should be followed by fields for Call Name 
and Call Type respectively. Additional fields can be specified in any 
order. 


Field Identifiers 


Field Name 
Call Name 


Call Type 

DTE Address 
Facilities 

Call User Data 
Parameters 
PU Name 

LU Number 
Printer Model 


Printer Destination 


Example 


Service 01h: Call (continued) 


The following example calls Eicon Technology in Montreal using the 


Call by Values option. It creates a session named “Eicon.” 
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Call Example 


Contents 
24 


56300026 


Description 
Total length of Call Data 


Field ID for Call Name 
Length of Call Name 
Call Name 

Field ID for Call Type 


Length of Call Type 

Call Type 

Field ID for DTE Address 
Length of DTE Address 


Eicon’s DTE Address 
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service 03h: Foreground Session Function 


Inputs 


Output 


Description 


Note 


32 


AH = 03h 

AL = Screen Update Flag 00h — do not enable screen updates 
O1h — enable screen updates 

BX = Session iD 


AL = Return Code OOh — successful 
01h — invalid session id 


This function brings the session with the specified Session ID to the 
foreground. If the Screen Update Flag is set to 1, all session activity 
will be displayed on the screen. If another session was already in the 
foreground then that session will automatically be placed into the 
background. 


It is the programmer's responsibility to make sure that the display 
adapter is in the proper mode (text or graphics) when a session is 
brought to the foreground. Access API assumes that the adapter is 
configured according to the requirements of the session. Ifa graphics 
session is brought to the foreground and the display is in text mode, 
the graphic screen will appear translated into random PC characters. 


service 02h: Hang Up Session Function 


Input AH = 02h 
AL = 00 
BX = Session ID 


Output AL = Return Code OOh — successful 


nak Os ete Ne oS os ee See Ed 
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Description This function hangs up the session with the specified Session ID. 
The session must be on-line. 


Note This function will not return until the session has been hung up. If 
there is a communication problem on the line that hampers the hang 
up procedure, the function might hold for a long time before com- 
pleting. 
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service 17h: Query Status 


Input 


Output 


AH = 11h 
AL = Mode 


BX = Session ID 
ES:DI 


Session Function 


OOh — regular mode 

Oth — X.25 mode 

80h — query & clear status line 

81h — overwrite device status area 

82h — overwrite help area 

83h — overwrite device status & help area 


address of a buffer to receive the Device Information String 


ES:SlI = address of a buffer to receive the Help String 


All Modes supply a Return Code in AL upon completion. Other output 
however differs between modes. 


AL = Return Code 


Regular Mode (00h) 
CL = State Byte 


CH = Status Byte 


X.25 Mode (01h) 
CL = State Byte 


CH = Status Byte 


DH = X.25 Cause Code 
DL = X.25 Diagnostic Code 


OOh — successful 
O1h — invalid session id 


O1h — session in foreground 
O2h — session on hold 

O3h — session in background 
O1h — waiting 

02h — calling 

O3h — connected 

O4h — hanging up 

O5h — hung up 

O6h — aborted 


01h — normal 

O2h — X.25 reset received 
O3h — X.25 clear received 
Oth — waiting 

02h — calling 

03h — connected 

04h — hanging up 

O5h — hung up 

O6h — aborted 


om - 
ig 
oa 
etillah, 


Description 


Service 11h: Query Status (continued) 


Query & Clear Status Line (80h) 


Device Status Length and Help Length are returned in the Device 
Information String. 


There are no output values for the following Modes. 
Overwrite Device Status Area (81h) 
Overwrite Help Area (82h) 

Overwrite Device Status & Help Area (83h) 


This function allows programs to monitor the status of Access 
sessions, as well as write information to the Access Status Line 
displayed at the bottom of each emulation screen. 


Modes O1 and 02 return information on Access Sessions. Modes 80h, 
81h, 82h and 83h control overwriting of the Status Line. 


Regular Mode 


This mode functions for all Access sessions. It returns a State byte, 
a Status Byte, and a 65 byte Device Information String. The Device 
Information String has the same format as the Device Information 
displayed at the bottom of the ACCESS offline menu screen. 


Device Information String for Modes OOh, O1h 


Offset Description 


Session name (and LU number if 3270 


type) 


Device type (3270 SDLC, 3720 QLLC, 
5250 SDLC, 5250 QLLC, ITI, VT100) 


PU name or the DTE address 


X.25 Mode 


This mode returns detailed information about X.25 sessions. It 
returns Cause and Diagnostic codes, as well as Status and State 
bytes. The State byte is cleared after the function completes. 


EGis’Access/X.25 User’s Guide — Appendix D: X.25 Cause and 
Diagnostic Codes 
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Service 17h: Query Status (continued) 


Query & Clear Status Line 


This mode returns two words in the Device Information Buffer: Device 
Status Length and Help Length. It also resets the Staus Line to its 
default value, cancelling out any previous modifications. 


Device Status Length is the number of character spaces available in 
the Device Status Area of the Status Line. This is the leftmost field 
which normally shows the Online to message. 


Help Length is the number of character spaces available in the Help 
Area of the current session. This is the area where function key 
assignments are normally displayed. For 3270 and 5250 sessions 
this is smaller than for than for ITI or VT100, as part of the Status 
Line is used for the OIA display. 


Device Information String for Mode 80h 


Offset Description 
00 Device Status Length 


16 Help Length 


Overwrife Device Status Area 


This mode overwrites the Device Status Area on the Status Line with 
bytes from the Device Information String and resets the Help Area to 
its default value. The number of bytes written is equal to Device 
Status Length. 


Overwrife Help Area 


This mode overwrites the Help Area on the Status Line with bytes 
from the Help String and resets the Device Status Area to its default 
value. The number of bytes written is equal to Help Length. 


Overwrite Device Status & Helo Area 


This mode overwrites the Device Status Area with bytes from the 
Device Information String, and the Help Area with bytes from the 
Help String. 


Service 92h: File Transfer 3270 Function 


Input 


Output 


Description 


AH 
AL 


12h 
file transfer control OOh — start file transfer 
O1h — abort file transfer 


BX = Session ld 
CX = length of File Transfer Command String 


ES:DI = address of File Transfer Command String 


AL = Return Code OOh — successful 
O1h — invalid session id 
02h — invalid length 
O3h — input inhibited 
04h — unable to enter command in field 
O5h — unable to open the file 
O6h — syntax error in file transfer string 
07h — not allowed to terminate 


This function allows applications to control 3270 file transfers. The 
length of the File Transfer Command String must be 200 bytes or 
less. It must be in the same format as when using Access interactively 
to initiate a 3270 file transfer. 


Access initiates the file transfer by entering the File Transfer Com- 
mand String into the 3270 screen of the specific session. The string 
is placed into the first available unprotected field after the current 
cursor position. If the file transfer command string is longer than the 
field, error 04 will occur. If the string is accepted, file transfer is 
initiated, and the function returns to the application with code 00. 
The application must use Service 10: Query Status to determine when 
the file transfer has completed. 
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Service OCh: Find Next Aftribute 3970 Function 


Input 


Output 


Description 


AH = OCh 
AL = Search Type OOh — any attribute 
O1h — unprotected field attribute 
BX = Session ID 
DX = Screen Buffer Offset where search will start 


AL = Return Code OOh — successful 
01h — invalid session id 
O2h — invalid offset 


DX = Offsetof Attribute -1h — if not found 


This function finds the next 3270 attribute searching forward from 
the specified Screen Buffer Offset. To obtain the value of the attribute, 
use Service 07: Read Buffer Character. 


ao 


Input 

T 
Output 
Description 


[ies amily 
oe 
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Service ODh: Find Previous Attribute 


AH = ODh 
AL = search type 


BX 
DX 


Session ID 


AL = Return Code 


DX = Offset of Attribute 


3270 Function 


NOh — any attribute 
Oth — unprotected field attribute 


Screen Buffer Offset where search will start 


OOh — successful 
O1h — invalid session id 
02h — invalid offset 


-1h — if not found 


This function finds the previous 3270 attribute searching backward 
from the specified Screen Buffer Offset. To obtain the value of the 
attribute, use Service 07h: Read Buffer Character. 


39 


40 


service 05h: Query Cursor | 3270 Function 


Input 


Output 


Descriotion 


AH = O5h 
AL = 00 
BX = Session ID 


AL = Return Code OOh — successful 

Oth — invalid session id 
DL = Cursor Column 
DH = Cursor Row 


This service returns the position of the cursor in the specified session. 
Maximum values for Cursor Column and Cursor Row depend on the 
terminal emulation in use. 
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Service 10h: Query Status 3270 Function 


Input AH = 10h 
AL = 00 
BX = Session ID 


Ou TOU i AL = Return Code OOh — successful 
Cin invaid session id 
CX = Status Word 
DL = number of columns 
DH = number of rows 
Description This function returns a Status Word that allows an application to 


monitor the activity of API function calls. 


| Status Word 


Meaning Notes 


the screen buffer has been cleared to zero each time this function is called 
modified 


OIA has been modified cleared to zero each time this function is called 
the session is connected 
a file transfer is in progress 


user traffic is allowed Input Not Inhibited, the device can now 
respond to the host 


data traffic is allowed activated by the host 


data received from the host each AID key sent sets this bit to 0, a reponse 
from host sets it to 1 


the screen is in graphics mode 
model number of the terminal 


extended highlight and color 
is active 


programmed symbols set active 


reserved 
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Service 07h: Read BufferCharacter —_3270 Function 


Input 


Output 


Description 


Note 


AH = O7h 

AL = format ofcharacter | OOh — device buffer format 
Oth — ASCIl 

BX = Session ID 

DX = Screen Buffer Offset 

AL = Return Code OOh — successful 


01h — invalid session id 

02h — invalid offset or format 
CL = Character 
CH = value for Extended Attribute Data 


This service returns the character at the indicated Screen Buffer 
Offset for the specified session. 


If the character is an attribute byte it will be returned in Device 
Buf-fer Format even if ASCII was specified. 


% , 
ae 
Sele” 


Meee scones 


Output 


Description 


service OEh: Read OIA 3270 Function 
Input AH = OEh 
AL = 00 


BX = Session ID 
ES:DI = address of a buffer to receive the OIA String 


AL = Return Code OOh — successtul 
O1h — invalid session id 


This functions returns a subset of the values for the 3270 Operator 
Information Area as specified by IBM. The OIA String is 46 bytes in 
length. 


OIA String 


Value 


System Readiness and Connection Sym- 
bols 


Input Inhibited 


Reminders 


Shifts 


EiassAccess /QLLC (3270 Support) User’s Guide— Operator Informa- 
tion Area Messages 
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Service OBh: Read String - 3270 Funetion 
Input AH = OBh 
AL = format of data OOh = device buffer format 


Oth = ASCI 
BX = Session ID 
CX = length of the String to read 
DX = Screen Buffer Offset 


ES:DI = address of the String 


Ou tout AL = Return Code OOh — successful 
O1h — invalid session id 
02h — invalid offset 
Description This service returns a String from the specified 3270 session. If the 


length of the String forces a read beyond the end of the 3270 Screen 
Buffer, error 02 occurs. 


iw) 
blk 
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Service 15h: Save Screen 3270 Function 


Input 


Output 


Description 


AH.= 15h 

AL = 00 

BX = Session ID 

CX = length of Destination String 


ES:DI = address of the Destination String 


AL = Return Code OOh — successful 
O1h — invalid session id 
02h — invalid length 
O5h — unable to open the file 


This function writes an image of the specified session’s Screen Buffer 
to the indicated Destination. The Destination String can be the name 
of any valid DOS file or device. The Destination String cannot exceed 
32 bytes. This command is functionally identical to the command 
under Access. 
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Service 09h: Send Keystroke 3270 Funetion 
Input AH = 09h 
AL = 00 


Output 


Description 


Note 
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BX = Session ID 
CX = KeylD of keystroke 


AL = Return Code OOh — successful 
Oth — invalid session id 
O6h — invalid KeyID 
10h — input inhibited 
12h — successful, AID sent 


This function aliows application programs to mimic user keyboard 
entry for a 3270 session. All keys sent by this function will produce 
the same results as if typed on the keyboard. In addition to regular 
keys, AID keys such as ENTER or PF1 may be sent. 


Applications should use Service 10h: Query Status to determine if data 
can be sent to the host. In an interactive scenario where the host 
application and the user application exchange a series of screens, 
the user should wait until Service 10h reports bits 4,5 and 6 as 1 
before trying to send a keystroke. 


Service 06h: Set Cursor 3270 Function 
Input AH = O6h 
AL = 00 


BX = Session ID 
DL = Cursor Column 
DH = Cursor Row 


Ou tout AL = return code 0Oh — successful 
O1h — invalid session id 
02h — invalid input data 


Descr ID tion This service places the cursor for the specified 3270 session. Maxi- 
mum values depend on the terminal emulation in use. 


Note Error 02 indicates that the cursor values are out of range or are 
within a protected field. 
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Service 08h: Write Buffer Character —_.3270 Function 


Input AH = 08h | i 
AL = format ofcharacter OOh = device buffer format P 
Oth = ASCIl | = 
BX = Session ID 
DX = Screen Buffer Offset | —_ 
CL = Character 


Ou fDU / AL = Return Code 00h — successful _ 
01h — invalid session id = 
02h — invalid offset or format = 
10h — input inhibited i‘ 
12h — invalid character _ 
OEh — protected field < 

Description This service places a character into the 3270 Screen Buffer of the . 

. specified session. Cursor position is updated. 


rate 


service OAN: Write String 3270 Function 
Input AH = OAh 
AL = format of data OOh = device buffer format 
O1h = ASCII 


Oufput 


Description 


Note 


BX = Session ID 
CX = length of String 
DX = Screen Buffer Offset 


ES:DI = address of String 


AL = Return Code OOh — successful 
O1h — invalid session id 
O2h — invalid offset 
10h — input inhibited 
12h — invalid character 
OEh — protected field encountered 


This function writes a String to the specified location in the Screen 
Buffer. Cursor position is updated. 


If the String overlaps attribute bytes or protected fields, the charac- 
ters that fall on these positions are skipped. 
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Service 31h: Query Cursor = =———s250Funotion 


Input AH = 31h 
| AL = 00 
BX = Session ID 


Output AL = Return Code OOh — successful 
01h — invalid session id 
DL = Cursor Column 
DH = Cursor Row 


Description This service returns the current cursor position for the specified 5250 
session. 


ese” 


2a 
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service 35h: Query Field Data 5250 Function 


Input 


Output 


Description 


Note 


AH = 35h 

AL = format 00h — EBCDIC 
O1h — ASCII 

BX = Session ID 


CL = Field Number Byte 
ES:DI = address of a buffer that will receive the Field Data 


AL = Return Code OOh — successful 
Oih — invalid session id 
02h — invalid format or field number 


This function returns the data stored in the specified input field. The 
buffer at ES:DI should be set to the field length value returned by 
service 34: Query 5250 Field Description. 


Applications can determine the Field Number Byte using Service 33h: 
Query Field Number Byte. 
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Service 34h: Query Field Description 5250 Function 


Input 


Output 


Description 


Note 


o2 


AH = 34h 

AL = 00 

BX = Session ID 

CL = Field Number Byte 


ES:DI = address of a buffer to receive the Field Descriptor 


AL = Return Code OOh — successful 
01h — invalid session id 
02h — field number is out of range 


This function returns an 8 byte Field Descriptor that lets an applica- 
tion determine various useful information about the fields on a 5250 
emulation screen. 


Field Descriptor 
Description 
field location (offset into 5250 buffer) — 
length of field 


Field Format Word (00 OO for Output 
fields) 


Resequence Number (00 for Output 
fields) 


Self-Check Module (00 for Output fields) 


Applications can determine the Field Number Byte using Service 33h: 
Query Field Number Byte. 


a 


= 


service 33h: Query Field Number 5250 Function 
Input AH = 33h 
AL = 00 


Oufput 


Description 


BX = Session ID 
DL = Cursor Column 
DH = Cursor Row 


AL = return code OOh — successful 

O1h — invalid session id 

O2h — cursor position out of range 
CL = Field Number Byte 
CH = total number of input fields defined 


This function allows an application to identify the Field Number Byte 
of each field on a 5250 screen. Once an application has this infor- 
mation it can use other functions to manipulate the field. 


The Field Number Byte contains bits that specify the Field Number 
and Field Type. Access API assigns a unique Field Number to each 
field on the 5250 screen. Field Type is either input or output. Any 
API function call that operates on a 5250 field requires the Field 
Number Byte as input. 


To get the Field Number Byte of a field requires a general method for 
detecting fields. This function uses a cursor position on the 5250 
screen as a Starting point. If the specified Cursor Row and Cursor 
Column fall on an input field then bit 7 of the Field Number Byte is 
set to O, and bits 0-6 give the Field Number. If Cursor Row and Cursor 
Column fall on an output field then bit 7 is set to 1 and bits 0-6 give 
the number of the preceding input field. If there is no preceding input 
field then bits 0-6 are set to zero. 
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Service 3Bh: Query DIM | 2 en eileen 


Input 


Output 


Description 


AH = 3Bh 

AL = 00 

BX = Session ID 

ES:DI = address of a buffer to receive the OIA String 


AL = Return Code OOh — successful 
01h — invalid session id 


This service returns a 32 byte DIM String. The DIM (Display Indicator 
Messages) String contains the messages displayed by Access in the 
OFFLINE and ONLINE menus. 


EGGess Access /SDLC (5250 Support) or Access/QLLC (5250 Support) 
User’s Guide —- Appendix B. 


Service 3Ch: Query Status 5250 Function 


Input 


Output 


Description 


AH = 3Ch 
AL = 00 


BX = Session ID 


AL = Return Code 


CX = Status Word 


OOh — successful 
fra kh 
Lo me | 


some smiivl ro} rN a | 
it ivaia session ia 


This function returns a Status Word that allows an application to 


monitor 5250 sessions. 


Status Word 


Meaning 
message waiting 


data link active 
SS-LU session active 


LU-LU session active 


cursor position modified 
format table modified 

status line modified 

5250 device buffer modified 
reserved 

error line in use 

input inhibited was turned off 
input inhibited was turned on 
input inhibited 

command mode 


insert mode 


cleared to O after this function returns 
cleared to O after this function returns 
cleared to O after this function returns 


cleared to 0 after this function returns 


cleared to O after this function returns 


cleared to O after this function returns 
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Service 37h: Read Buffer Character 


5250 Screen Buffer. 


5250 Function 


Input AH = 37h 
| AL = format 00h — EBCDIC 
O1h — ASCIl 
BX = Session ID 
DL = Column 
DH = Row 
Ou TDU i AL = Return Code 00h — successful 
01h — invalid session id 
02h — invalid format or row/column 
outside of screen 
CL = Character 
Description This service returns the character at the specified position in the 


Service 39h: Read Siring 5250 Function 
Inout AH = 39h 
AL = format 00h — EBCDIC 
O1h — ASCII 


Output 


Description 


BX = Session ID 
CX = length of String 
DL = Column 

DH = Row 


ES:Vi = address of buffer io receive the String 


AL = Return Code OOh — successful 
Oth — invalid session id 
O2h — invalid format or string is (partially) 
outside of screen 


This function returns a string of characters from the 5250 Screen 
Buffer. It does not recognize input or output fields, and will return a 
value right across field boundaries. 
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Service 3Dh: Save Screen 5250 Function 
Input AH = 3Dh 
AL = 00 


Output 


Description 


BX = Session ID 
CX = length of Destination String 
ES:DI = address of Destination String 


AL = return code OOh — successful 
01h — invalid session id 
O2h — invalid string length 
O5h — unable to open the file 


This function copies the contents of the 5250 Screen Buffer to the 
file or device specified by the Destination String. The Destination 
string must not exceed 32 bytes. 


Lncuarerwensie! 
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service 30h: Send Keystroke 5250 Function 


Input 


Outout 


Description 


Notes 


AH = 30h 

AL = 00 

BX = Session ID 

CX = KeylD of keystroke 


AL = Return Code oon — successfui 
01h — invalid session id 
10h — input inhibited 
11h — key results in an operator error 
14h — next alphanumeric key will produce 
an operator error 


This function allows an application program to mimic user keyboard 
entry for a 5250 session. All keys sent by this function produce the 
same results as if typed on the keyboard. In addition to regular keys, 
AID keys such as ENTER or PF 1 may be sent. 


Before using this function, applications should determine if keyboard 
entry is allowed by calling Service 3Ch: Query 5250 Status. 
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Service 32h: Set Cursor. 


Input AH = 32h 
AL = 00 
BX = Session ID 
DL = column 


5250 Function 


DH = row 
Output AL = return code OOh — successful 
01h — invalid session id 
O2h — cursor position out of screen 
10h — move ignored because input inhibited 
11h — move results in an operator error 
Description This service sets the cursor position for the specified 5250 session. 


aoe 


== 
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Service 38h: Write Buffer Character 


Input 


Output 


Description 


AH — 38h 
AL — format 


BX — Session ID 
CL — Character 
DL — Column 


On Row 


AL — Return Code 


5250 Function 


00h — EBCDIC 
Oth — ASCli 


OOh — successful 

O1h — invalid session id 

O2h — invalid format or 
illegal row/column position 

10h — ignored - input inhibited 

11h — operator error 

14h — executed, but a warning is issued 
that the next alphanumeric key, if 
sent, will produce an operator error 


This service places a Character into the 5250 buffer at the specified 


position. 
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service 3AN: Write String 5250 Function 
Input AH = 3Ah 
AL = format 00h — EBCDIC 
01h — ASCII 


Output 


Description 


BX = Session ID 

CX = length of String 
DL = Column 

DH = Row 


ES:DI = address of String 


AL = Return Code OOh — successful 

O1h — invalid session id 

02h — invalid format or 
row/column position outside of screen 

10h — ignored - input inhibited 

11h — operator error 

14h — executed, but a warning is issued 
that the next alphanumeric key, if 
sent, will produce an operator error 


This service writes a String to the Screen Buffer of the specified 
session. Characters are placed mimicking keyboard entry (skip to 
next field when a field becomes full, wrap around at the end of the 
screen). 


or i 
bi 


service 36h: Write String fo Field 5250 Function 


Input AH = 36h 
AL = format 00h — EBCDIC 
O1h — ASCII 
BX = Session ID 
CL = Field Number Byte 
ES:DI = address of String 
Ou TOU i AL = Return Code OOh — successful . 


O1h — invalid session id 

O2h — invalid format or 
field number out of range 

10h — ignored - input inhibited 

11h — operator error 

14h — executed, but a warning is issued 
that the next alphanumeric key, if 
sent, will produce an operator error 


Description This service writes a String into the specified 5250 field. 


N ofe Characters are placed into the field one at a time, mimicking key- 
board entry. If illegal characters are contained in the string an 
operator error is issued when they are encountered. Previous char- 
acters are still entered into the field. Strings that exceed the field size 
are truncated. 


Applications can determine the Field Number Byte using Service 33h: 
Query Field Number Byte. 
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service 1Eh: File Capture ITY Function 
Input AH = 1Eh 
AL = file capture control OOh — capture on 
01h — capture off 


Output 


Description 


BX = Session ID 
CX = length of Device Name 


ES:DI = address of Device Name © 


AL = return code OOh — successful 
01h — invalid session id 
02h — invalid length 
O5h — unable to open file 


This function toggles file capture mode on or off. The captured file 
can be redirected to any legal DOS device (printer, file, screen). 
EGesAccess/X.25 User’s Guide — The F2 Capture Command 
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Service 1Dh: File Transfer 


Input 


Output 


Description 


TTY Function 


AH = 1Dh 

AL = file transfer control OOh — send binary file 
01h — send ASCIl file 
02h — abort file send 


BX = Session ID 
CX = length of File Name 


ES:DI = address of File Name 


OOh — successful 

O1h — invalid session id 

O2h — invalid length 

O5h — unable to open file 

O6h — file transfer in progress 


AL = Return Code 


This function allows applications to control TTY File Transfers. The 
File Name should not exceed 32 bytes. Applications should use 
Service 1Fh: Query TTY Status to determine when the file send is 
complete. 
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Service 22h: Flush yt Try Function 


Input 


Output 


Description 


Notes 


AH = 22h 
AL = 00 
BX = Session ID 


AL = Return Code OOh — successful 
O1h — invalid session id 


This function can be used to force data in the PAD buffer to be 
transmitted. 


It may not be necessary to call this function if the PAD parameters 
are set to transmit the data automatically. 


EGGess Access /X.25 User’s Guide —- Appendix B. ITI PAD Parameters 


Service 20h: Match TTY Function 
Input AH = 20h 
AL = option OOh — start match 


Output 


Description 


Note 


O1h — abort match 
BX = Session ID 
CX = length of Match String 


ES:DI = address of Match String 


AL = Return Code OOh — successful 
01h — invalid session id 
O2h — invalid string length 


This function attempts to match the Match String with the input data 
stream. This function returns immediately, applications should use 
Service 1F: Query Status to determine if the match is successful or 
not. The Match String may not exceed 128 bytes. It only needs to be 
supplied for option 00 (start match). 

EqtiAccess /X.25 User’s Guide — Script Commands & Their Syntax 


Only one session at a time may have a match in progress. 
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service 18h: Query Cursor ‘e TTY Function 


Input AH = 18h 
AL = 00 
BX = Session ld 


Output AL = Return Code OOh — successful 
O1h — invalid session id 
DL = column 
DH = row 


Description This function returns the current cursor position in an ITI or VT100 


session. 


Puy 
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Service 1Fh: Query Status TTY Function 


INput 


Oufput 


Description 


AH = 1Fh 
AL = 00 
BX = Session ID 


AL = Return Code OOh — successful 
Cin — ivangd SESSiGn 1a 
CX = Status Word 
DL = number of rows 
DH = number of columns 


This function returns a Status Word that allows applications to 
monitor the progress of API calis. The Status Word format is: 


Status Word 


Meaning Notes 
sting match successful 


string match in progress a successful match sets this bit to 0 


session active 


a connection has been established 


file transfer in progress 


binary file transfer /receive in 


progress 


file capture enabled 


send buffer is full cannot send keystoke 


receive buffer is empty nothing to read 


reserved 
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Service 1Bh: Read Buffer Character ITY Function 


Input 


Output 


Description 


AH = 1Bh 

AL = 00 

BX = Session ID 

DX = Screen Buffer Offset 


AL = Return Code OOh — successful 
O1h — invalid session id 
10h — invalid offset 

CL = Character 


This service returns a single character from the TTY buffer. The 
character is in ASCII format. 


Service 19h: Read Next Character ITY Function 
Inout AH = 19h 
AL = 00 


Output 


Description 


BX = Session ID 


AL = Return Code OOh — successful 
Oin — invaiid session id 
or session not on hold 
10h — no data to read 
CL = Character 


The session must be put on Hold (Service 04: Background) before this 
function can be used. This function intercepts the next character as 
it arrives from the remote and returns it in register CL. The character 
is not passed to Access (it will not be placed into the screen buffer or 
if it is a movement key it will not be interpreted). 
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Input 


Service 1Ch: Read String ITY Function 
AH = 1Ch 
AL = 00 


Oufput 


Description 


Note 


BX = Session ID 
CX = length of the String 
DX = Screen Buffer Offset 


ES:DI = address of a buffer to receive the String 


AL = return code OOh — successful 
O71h — invalid session id 
10h — invalid offset 


This function returns an ASCII String of the indicated length from 
the TTY Screen Buffer. 


If the return string exceeds the end of the Screen Buffer (Screen 
Buffer Offset + length of string > size of Screen Buffer), random 
characters will be returned for all positions beyond the edge of the 
screen Buffer. 


5 (Service 18h: Send Keystroke ITY Function 
I 
i Input AH = 18h 
o AL = 00 
i BX = Session ID 
I CX = KeylD of the keystroke 
_ Output AL = Return Code O0h — successful 
i 01h — invalid session id 
+ 10h — invalid key value or TTY buffer full 
Descriotion This function allows application programs to mimic user keyboard 


entry for TTY and VT100 sessions. All keys sent by this function will 
produce the same results as if typed on the keyboard which is 
dependent on the current state of the PAD parameters. For example, 
if echo is on, keystrokes will be echoed to the screen. 


In addition to regular keys, special keys such as cursor moves and 
PF 1 may be sent 


BetessAccess/X.25 User’s Guide — Appendix B. ITI PAD Parameters 
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Service 24h: Set PAD Parameters ——™~—somvtunctton 


Input 


Output 


Description 


Notes 


AH = 21h 

AL = read/write flag OOh — read PAD parameters 
Oih — write PAD parameters 

BX = Session ID 

CX = length of PAD String 


ES:DI = address of PAD String 


AL = return code OOh — successful 
01h — invalid session id 
02h — invalid length 
O3h — invalid PAD parameter 


This function allows you to set PAD parameters for the specified 
session. The PAD String cannot be longer then 128 bytes and should 
follow the format specified in the Access User’s Guide. 


FaressAccess/X.25 User’s Guide — Appendix B. ITI PAD Parameters 


The PAD String is only needed when the read/write flag is 01. 


r( «Executable DOS Files 


The section provides a detailed description of each of the Executable 
DOS files. There are 19 files. They are arranged in alphabetical order. 


lis) 
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38270 Command 


32/0FT: 3270 File Transfer 


Summary 


Return Value 


Description 


Note 


3270FT { "Command String" | /STOP } [ /l=/nterrupt ] 


ERRORLEVEL = 00 — successful 
01 — no active sessions or invalid session type 
04 — unable to enter command in field 
05 — unable to open file 
O6 — syntax error in command string 
07 — not allowed to terminate 
10 — invalid parameter 
11 — Access API not resident 


This command allows the user to initiate and terminate a 3270 file 
transfer in the current foreground session. To initiate the transfer a 
Command String must be supplied enclosed in quotes. This string 
should be in the same format as entered when using the Access 
application program interactively. EggsrAccess/QLLC (3270 Sup- 
port) or Access/SDLC (3270 Support) User’s Guide — The F1 File 
Transfer Key 


The /STOP switch aborts any active file transfer. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


This command returns as soon as the file transfer has started. Use 
WAIT 3270FT to determine when the transfer is complete. 


coo 


ANSWER: Create an ITl Answer Session — ticommana 


Summary 


Return Value 


Description 


Note 


ANSWER Name [ /l=/nterrupt | 


ERRORLEVEL = 00 — successful 
01 — name not found 
O02 — answer unsuccessful 
10 — invaia parameter 


11 — Access API not resident 


This function creates an ITI answer session. The Name must exist in 
the Access calling directory. This function returns immediately 
without waiting for completion of the connection. Use the WAIT 
command to determine when the incoming call has connected. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


This function is for ITI sessions only. 
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‘CALLS: Make a Call 


Summary 


Return Value 


Description 


Note 


3270, 5250, ITl Command 


CALL Name [/l=/nterrupt] 


ERRORLEVEL = 00 — successful 
01 —name not found 
02 — call failed 
10 — invalid parameter 
11 -— Access API not resident 


This function makes a 3270, 5250, or ITI call. If Name exists in the 
Access calling directory, this function will try to make the call using 
the parameters it finds. If the call is successful then this session 
becomes the current foreground session. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


This function only returns once the call has been completed or 
rejected. Also, if Name is that of an Autolog (.ALG) file, the file will be 
opened and executed exactly as if it were being run under Access. 
Depending on the nature of the Autolog file this might lead to screen 
updates being enabled and messages being written to the display. 
EGGES Access /X.25 -— Autostart & Autolog Features 


ere! 


COMPARE: String Comparison _3270, 5250, ry Command 


Summary COMPARE "String" Offset [ /l=Interrupt ] 
Return Value ERRORLEVEL = 00 — successful 


01 — no active sessions or invalid session type 
02 — no match 
10 — invaiG parameter 


11 — Access AP! not resident 


Description This function compares the characters in String with those starting 
at Offset in the Screen Buffer of the current foreground session. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 
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CAPTURE: Capture TTY File ITY Command 


Summary 


Refurn Value 


Description 


CAPTURE { Device Name | /OFF } [ /l=/nterrupt ] 


ERRORLEVEL = 00 — successful 
01 — no active sessions or invalid session type 
03 — already in capture mode 
05 — unable to open target file 
10 — invalid parameter 
11 — Access API not resident 


This function turns TTY file capture on or off. Device Name can be 
the name of a file or a printer port (LPT1, LPT2). 
EEGes Access/X.25 — Autostart & Autolog Features 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


ENDAPI 


Summary 


Refurn Value 


Description 


3270, 5250, TTY Command 


ENDAPI [ /l=/nterrupt | 


none 


This function closes the API interface. Since each of the Executable 
DOS functions does this automatically, this function should only be 
used when a function is prematurely aborted. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 
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GETSCR: Display Screen Buffer 3270, 5250, TY Command 


Summary 


Refurn Value 


Description 


Examples 


GETSCR Offset Number Length [ Session Number ] [ /l=Interrupt ] 


ERRORLEVEL = 00 — successful 
01 — no active sessions or invalid session type 
10 — invalid parameter 
11 -— Access API not resident 


This function displays characters from the screen buffer of the 
selected session. If no session is specified the current foreground 
session is used. Characters are displayed beginning at location Offset 
and ending at location Offset + Length. The output of this function 
is displayed on the screen, however it can be redirected to a file or 
printer using the DOS redirection commands. 

Eqzpss IBM Disk Operating System Reference — Standard Input and 
Standard Output | 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


GETSCR 149 Returns 4 characters starting at posi- 
tion 1 in session number 9. | 


GETSCR 10 80>SCR.TXT Sends 80 characters starting at posi- 
tion 10 in the current foreground ses- 
sion to the file SCR.TXT. 


GETSCR 0 1919 Ipt1 Sends the entire screen of the current 
foreground session to the printer. 


sli - 


GETSTAT: Query Access Type 3270, 5250, TTY Command 


Summary GETSTAT [ /l=Interrupt ] 
Return Value ERRORLEVEL = 101— X25 
102— QLLC 
106— SDLC 
Description This function allows the user to determine the option of the Access 


software currently running. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 
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HANGUP: Hang up a Session 


Summary 


Return Value 


Description 


Note 


3270, 5250, TTY Command 


HANGUP [/l=/nterrupt] 


ERRORLEVEL = 00 — successful 
01 —nocurrent session 
11 — Access API not resident 


This function hangs up the current foreground session. If there are 
other active sessions, the SWITCH command can be used to bring 
another session to the foreground. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


This function does not return until the session has been hung up. If 
there is a communication problem on the line that hampers the hang 
up procedure, the function might hold for a long time before com- 
pieting. | 


PER sacs 
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HOTKEY: Hot Key Switch 


Summary 


Return Value 


Description 


Note 


3270, 5250, TTY Command 


HOTKEY [| /l=/nterrupt | 


ERRORLEVEL = 00 — successful 
11 — Access API not resident 


This service causes the Access program to be activated in interactive 
mode. Access comes up with the current foreground session active 
and with keyboard input and screen updates enabled. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


There is no mechanism to prevent the user from Hot Keying out of 
Access as with the Assembler function (Service 13h: Hot Key Switch). 
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MATCH: Match Input Stream eee 


Summary 


Return Value 


Description — 


Example 


MATCH {[ "String" ] [/Hex Value ] [ /Attribute ] | /STOP } 
[ /l=/nterrupt ] 


ERRORLEVEL = 00 — successful 
01 — no active sessions or invalid session type 
03 — match in progress 
10 — invalid parameter 
11 — Access API not resident 


This function tries to match the specified String, Hex Value, Attribute 
or a combination of all three with the input data stream being 
received by the current foreground session. The WAIT command 
should be used to determine if the match is successful or not. 


Hex Value is a two-digit hexadecimal number. Attribute can be the 
characters CR, LF or TAB. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a number indicating the new setting. 


The following is an excerpt from a DOS batch file. It illustrates how 
to use the MATCH command in combination with the WAIT com- 
mand. 


MATCH "Password:" /TAB Try to match the character string 
"Password" followed by a tab. 


WAIT MATCH 30 Wait until the match completes or 30 
seconds has elapsed. 


IF ERRORLEVEL 1 GOTO STPMAT 
Jump to STPMAT if the ERRORLEVEL 
is 1 or greater. 


GOTO NEXT The ERRORLEVEL was 00 indicating 
success. Jump to the label NEXT which 
would continue execution of the batch 


file 
-STPMAT Stop looking for a match. 
MATCH /STOP 
GOTO QUIT Exit the batch file 


fy 


PUTSCR: Write Data to Session 


Summary 


Refurn Value 


Descriofrion 


Note 


Examples 


3270, 5250, TTY Command 


PUTSCR [Session Number | [{/ l=/nterrupt | 


ERRORLEVEL= 00 — successful 
01 — no active session 
or invalid session id 
10 — ifivaiid parameier 
11 -— Access API not resident 
16 — input inhibited 
17 — 5250 operator error 


This command copies data from STDIN (standard input, usually the 
keyboard) to the current cursor position in the foreground session. 
The process stops when end-of-file is encountered (CTRL-Z). 
ECGs IBM Disk Operating System Reference — Standard Input and 
Standard Output 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


STDIN can be redirected to be a file or even another function. 


PUTSCR 1 Accept input from the keyboard and 
place it into the current foreground 
session. This process continues until 
CTRL-Z and RETURN are pressed. 


PUTSCR 1 < MESSAGE Copy the characters in the file MES- 
SAGE to session 1. 


GETSCR 0 80 2| PUTSCR Grab 80 characters from session 2 and 
send them to the current foreground 
session. 
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SCRSAVE:; Save Screen fo File 


Summary 


Return Value 


Description 


3270, 5250 Command 


SCRSAVE Filename [ /l=/nterrupt ] 


ERRORLEVEL = 00 — successful 
01 — no active sessions or invalid session type 
05 — unable to open file 
10 — invalid parameter 
11 — Access API not resident 


This function saves an image of a 3270 or 5250 session screen toa 
file. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


MEE ose 
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SEND: Send ITY File TTY Command 


Summar Y SEND {[/ASCII ] Filename | /STOP } [ /l=/nterrupt ] 
Return Value ERRORLEVEL = 00 — successful 


01 — no active sessions 

or invalid session type 
O05 — unable to open the tile 
06 — already sending 
10 — invalid parameter 
11 — Access API not resident 


Description This function initiates and terminates TTY file transfers in the 
current foreground session. The /ASCII switch sends the file in ASCII 
format, otherwise the transfer occurs in binary format. 


The /STOP switch aborts the transfer. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


Note This command returns as soon as the file transfer has started. Use 
the WAIT command to determine when the transfer is complete. 
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SETCURS: Sef Cursor Position 3270,5250Command 
Summar Y | SETCURS Column Row [ /l=Interrupt ] 
Return Value ERRORLEVEL = 00 — successful 
O01 — no active sessions or invalid session type 
02 — invalid input data 
10 — invalid parameter 
11 — Access API not resident 
16 — input inhibited 
17 — 5250 operator error 
D escription This function sets the cursor position in current foreground session. 
The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


si 


SWITCH: Switch Session 


Summary 


Return Value 


Descriotion 


3270, 5250, TTY Command 


SWITCH [Name ] [ /l=/nterrupt ] 


ERRORLEVEL = 00 — successful 
01 — nosessions 
11 — Access API not resident 
14 — Name not found 


This command brings the session with Name to the foreground. If no 
name is specified then the next foreground session becomes the 
session according to growing Session ID. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 
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TYPES: Send Keystrokes 


Summary 


Return Value 


Description 


3270, 5250, TTY Command 


TYPES ["String"] [/Function Key] [/Hex Value ] [ /l=/nterrupt | 


ERRORLEVEL = 00 — successful 
01 — no active session or invalid session type 
10 — invalid function key 
11 — Access API not resident 
17 — 5250 operator error 
18 — AID key successfully sent 


This command can be used to send a String, a Function Key, a Hex 
Value or any combination of the three to the current foreground 
3270, 5250, and TTY session. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


A String is ASCII characters delimited by quotes. 
Hex Value is a one- or two-digit hex number. 
Function Key is a value from one of the following tables: 


VT100 Function Keys 


Description Description 


(backspace) (numeric 2) 
(delete) (numeric 3) 
(cursor down) (numeric 4) 
(cursor left) (backspace) 
(cursor right) (numeric 5) 
(cursor up) (numeric 6) 
(numeric enter) (numeric 7) 
(escape) (numeric 8) 
(line feed) (numeric 9) 
(numeric - ) 

(numeric , ) 

(numeric. ) 

(numeric QO) 

(numeric 1) (return) 


send 


{ 7 Types: Write String 


- Tl Function Keys 
7 Description Key Description 
| (carriage return) TAB (horizontal tab) 
(line feed) 
1 | 
' 32/70 Function Keys 
. | | Only one of these AID keys may be used per TYPES command 
a and it must be the last keystroke sent to the session. 
i | Key Description Key Description 
7 PAI PF10 
7 PA2 PF11 
PA3 PF12 
ATTN (attention) PF13 
; SYSREQ (system request) PF14 
Fy | CURSEL (cursor select) PF15 
d ENTER PF16 
: CLEAR PF17 
PF] PF18 
PF2 PF19 
PF3 PF20 


T PF4 PF21 
PFS PF22 

PF6 PF23 

PF7 PF24 

PF8 

PF9 


The following AID keys may be repeated. 


Key Description Key Description 
CLEAR ERSINP (erase input) 
CURDN (cursor down) FASTLT (fast cursor left) 
CURLT (cursor left) FASTRT (fast cursor right) 
CURRT (cursor right) FM (field mark) 
~ | CURUP (cursor up) HOME 
7 DEL (delete) NL 


DUP RESET 
CLEAR RTAB (right tab) 
ERSEOF (erase end of file) TAB 
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Types: Write String q : . 
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Key 


ATTN 
BKSP 
CLEAR 
CMD 
COLOR 
CURDN 
CURLT 
CURUP 
CURRT 
DEL 
ERSINP 
DUP 
ENTER 
FADV 
FASTLT 


Description 


(attention) 
(backspace) 


(command mode) 


(cursor down) 
(cursor left) 
(cursor up) 
(cursor right) 
(delete) 

(erase input) 
(duplicate) 
(record advance) 
(field advance) 
(fast cursor left) 


FASTRT (fast cursor right) 


FBKSP 
FEXIT 


(field backspace) 
(field exit) 


FMINUS (field minus) 


FPLUS 
HELP 
HEX 
HOME 
INS 

NL 
PRINT 


(field plus) 


(hexadecimal) 


(insert) 
(new line) 


RESET (errror reset) 
ROLLDN (roll down) 


Key Description 


ROLLUP (roll up) 


SYSRQ@ (system request) 


TEST 


PF] 
PF2 
PF3 
PF4 
PFS 
PF6 
PF7 
PF8 
PF9 
PF10 
PF11 
PF12 
PF13 
PF14 
PF15 
PF16 
PF17 
PF18 
PF19 
PF20 
PF21 
PF22 
PF23 
PF24 


: is la 

; 
9250 Function Keys | A 
Only one of these AID keys may be used per TYPES command a 
and it must be the last keystroke sent to the session. - 
tai] 


Summary 


WAIT: Wait for an Event 


Refurn Value 


Description 


32/0, 5250, TTY Command 


WAIT { SEND | MATCH | 3270FT | ANSWER | RESPONSE } [ Delay ] 
[ A=Interrupt ] 


ERRORLEVEL = 00 — successful 
O1 — no current or invalid session type 
Oe — tiniG Sxpirea 
11 — Access API not resident 
16 — Input inhibited 
17 — 5250 operator error 
18 — AID key sent successfully 


This function allows a user to wait until an event completes. Delay 
controls the length of time (in seconds) this command will wait. If no 
Delay is specified, the function waits until the event occurs. Delay 
can be used alone without any of the other options to pause execution 
of a series of commands. 


Each keyword forces this function to wait for an event as follows: 


SEND 
MATCH 
3270FT 
ANSWER 


RESPONSE 


waits for completion of a TTY file transfer 
waits for successful match 
waits for a 3270 file transfer to complete 


waits for the current foreground session, which 
is in waiting state, to receive its connection 


waits for data to be received from a 3270 host 
and Input Not Inhibited 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 
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WRSTRING: Write String 3270, 5250 Command 


Summar Y WRSTRING "String" Offset [A=Interrupt] 


Return Value ERRORLEVEL= 00 — successful 
01 — no active sessions or invalid session type 
02 — invalid offset 
06 — invalid character in string 
10 — invalid parameter 
11 — Access API not resident 
14 — protected field encountered 
16 — input inhibited 
17 — 5250 operator error 


Description This function writes a string of characters to the Screen Buffer of the 


current 3270 or 5250 session. Offset is the Screen Buffer offset where 
the write will begin. String is an ASCII string delimited by quotes. 


The /I switch is tells the API interface that the software interrupt has 
been altered. It is followed by a hexadecimal number indicating the 
new setting. 


fe pra A: 
The KeyID Number 


The KeyID number allows identification of any function key on the 
3270, 5250 and VT-100 keyboards, as well as any key on the PC 
keyboard. It is a four-digit hexadecimal number. 


3276 SPA. ial 
Z/A/uKGYSs 


r Function Key KeylID | Function Key KeyID 
PAI 0200h | PF17 021Fh 
PA2 0201h | PF18 0220h 
DUP 0202h | PF19 0221h 
, FIELD MARK 0203h | PF20 0222h 
: ATTENTION 0204h | PF21 0223h 
= SYSTEM REQUEST 0205h | PF22 0224h 
1 CLEAR 0206h | PF23 0225h 
ERASE EOF 0207h | PF24 0226h 
CURSOR SELECT 0208h | PA3 0227h 
7 ERASE INPUT 0209h | ALT CURS 0228h 
a RESET 020Ah 
ENTER 020Bh Extended Keys 
NEW LINE 020Ch | EH DEFAULT 0229h 
FAST CURSOR RT 020Dh/| EH BLINK 022Ah 
FAST CURSORLT 020Eh | EH REVERSE 022Bh 
_ PFI 020Fh | EH UNDERSORE 022Ch 
i PF2 0210h | COLOUR DEFAULT 022Dh 
. PF3 021lh | BLUE 022Eh 
PF4 0212h | RED 023Fh 
_ PF5 0213h | PINK 0230h 
a PF6 0214h | GREEN 0231h 
me PF7 0215h | TURQUOISE 0232h 
i PF8 0216h | YELLOW 0233h 
PF9 0217h | WHITE 0234h 
PF10 0218h | PS DEFAULT 0235h 
PF11 0219h | PSA 0236h 
PF12 021Ah | PS B 0237h 
PF13 021Bh/ PSC 0238h 
PF14 021Ch | PS D 0239h 
- PF15 021Dh| PSE 023Ah 
i PF16 021Eh| PSF 023Bh 
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Appendix A: The KeyID Number 


5250 Non Command Mode Keys 


The following are non-command mode function keys. An 
attempt to enter them while in command mode will result in 
an error. 


Function Key KeyID | Function Key KeyID 


CURSOR DOWn 0600h | COLOR 061Bh 
CURSOR UP 0601lh | HEXADECIMAL 061Ch 
CURSOR RIGHT 0602h | CLEAR 061Dh 
CURSOR LEFT 0603h | TEST O61Eh 
FAST CURSOR RT 0604h | PF1 061Fh 
FAST CURSOR LT 0O605h | PF2 0620h 
BACKSPACE 0606h | PF3 0621h 
NEWLINE 0607h | PF4 0622h 
FIELD ADVANCE O608h | PF5 0623h 
FIELD BACKSPACE O609h | PF6 0624h 
FIELD EXIT O60Ah | PF7 0625h 
FIELD PLUS O60Bh | PF8 0626h 
FIELD MINUS O60Ch | PF9 0627h 
ENTER/RECORD PF 10 0628h 
ADVANCE O60Dh | PF11 0629h 
ROLL DOWN O60Eh | PF12 062Ah 
ROLL UP O60Fh | PF13 062Bh 


- HOME 
DELETE 
INSERT 
DUPLICATE 
ERASE INPUT 
SYSTEM REQUEST 
ATTENTION 


HELP 
PRINT 


ERROR RESET 


0610h 
0611h 
0612h 
0613h 
0614h 
0615h 
0616h 
0617h 
0618h 
0619h 


COMMAND MODE 061Ah 


PF14 
PF15 
PF16 
PF17 
PF18 
PF19 
PF20 
PF21 
PF22 
PF23 
PF24 


062Ch 
062Dh 
062Eh 
062Fh 
0630h 
0631h 
0632h 
0633h 
0634h 
0635h 
0636h 


is 


ri 


il 


1 . Access AP/ Programmer's Reference 


i 
i 5250 Command Mode Keys 
< The following are command mode function keys. An attempt to 
enter any of them while not in command mode results in an 
error. 
| T Function Key KeyID | Function Key KeyID 
- RESET COMMAND rrivo 0o45n 
1 MODE 0637h | PFI1 0646h 
7 COLOR 0638h | PFI12 0647h 
1 HEXADECIMAL  0639h PF13 0648h 
CLEAR O63Ah PF 14 0649h 
TEST O63Bh PF15 064Ah 
PF 1 063Ch PF16 064Bh 
PF2 063Dh PF 17 064Ch 
PF3 O63Eh PF18 064Dh 
L PF4 063Fh PF19 064Eh 
PF5 0640h PF20 064Fh 
PF6 0641h PF21 0650h 
PF7 0642h PF22 O651h 
¥ | PF8 0643h PF23 0652h 
( PF9 0644h | PF24 0653h 
, PF10 0645h 
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Appendix A: The KeyID Number ~~» ; 
, 
Lb 
VT100 Keys : 
The following are command mode function keys. An attempt Jf it 
to enter any of them while not in command mode resultsin § oe 
an error. | ie 
Function Key KeyiD | Function Key KeylID 
PFI 0200 numeric 3 O20E | = 
PF2 0201 numeric 4 O20F bl 
PF3 0202 numeric 5 0200 | — 
PF4 0203 numeric 6 0201 LL 
numeric - 0204 numeric 7 0202 re ca 
numeric , 0205 numeric 8 0203 se! 
numeric . 0206 numeric 9 0204 ~ a 
numeric ENTER 0207 CURSOR LEFT 0205 | La 
BACKSPACE 0208 CURSOR RIGHT 0206 es ca 
DELETE 0209 CURSOR UP 0207 it 
LINE FEED 020A CURSOR DOWN 0208 _ 
numeric O 020B RETURN 0209 bas 
numeric 1 020C ESCAPE 020A : Bis 
numeric 2 020D mm he 
e * 
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App 


endix B: 


Modifying Executable DOS Files 


The Executable DOS files provide batch file access to Access API 
functions. Each Executable file is a small program written in the C 
language that implements one API function. To keep things simple 
each function opens and closes the API interface when it is run. This 
gives the user complete freedom when making use of the programs. 


The Executable DOS files were written with the Microsoft C Compiler 
Version 4.0. If you are going to use another compiler to recompile 
the code, you might have to make some minor alterations to the files 
so they will compile properly. 


The source code for all the Executable DOS files is located in the 
SOURCE subdirectory on the API diskette(s). They have the file 
extension .C. In addition to these files, there are two other files that 
were used to help develop the Executable DOS Files. They are 
UTILS.C and API.H. 


UTILS.C 


This file contains the source code for six utility functions that are 
used repetitively by all the other Executable DOS Files. Compile this 
file and link it with the other programs when you modify them. 


API.H 


This header file defines constants used by all the programs. It is 
"included" at the beginning of each source code file. 


Design 
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Appendix B: Modifying Execufable DOS Files 


Source Code for the following is commented source code for UTILS.C. Study it before 


‘ae 
UT/ [ S C you begin to modify the Executable DOS Files or write your own C 
; functions. 
/* utils.c Copyright (c) Eicon Technology Corp. 1988 _— 
Description: This file contains six functions that are used repetitively iL. 


by the other Executable DOS files. They are: 


start_api() 

end_api() 

ret_current_id() 

set_fg( sessid ) 

set_interrupt( argc_p, argv_p) 


hex_value( code ) a 
Usage: Compile this file and link the resulting .OBJ file with the other _ 
API programs. | i. 
*/ | rane, 
#include <dos.h> | ca 
#include <string.h> 
#include "“api.h" can 
unsigned char int_value; /* current value of the software interrrupt */ Nee 
kkkkkkkkkkkkkkKKkeKkKRRKRaRK;RK KKK KKK KKK RK RRR KK KRRKK RRR KKK RRR ARR KK aX i 
/* start_api: This function starts the API interface using Service OOh. It oy 
checks to make sure that the current software interrupt is not set to zero : Sd 
_and that Access API is indeed at the other end of the interrupt. | 
—* as 
char start_api() _ 
£ | _ 
char bufstat[65]; 7 ae 
int res, buf[2]; | 
struct SREGS sgregs; | ae i, 


union REGS registers; 
unsigned int destseg, srcoff, bufadr; | | 


/* Check if the interrupt vector for the current software interrupt is not 
zero. If it is zero and we issue an interrupt we will crash the system. Note 
that at this point we are still not sure that Access API has been loaded. 
All we know is that the interrupt exists. It could be some other program. */ 


destseg = sgregs.ds; 
segread( &sgregs ); 
srcoff = int_value * 4; 
bufadr = buf; 


= 
movedata( 0, srcoff, destseg, bufadr, 4); — 
if ( buf[O] == 0 && buf[1] == 0) 7 = 

return( 1); a 


ole) aii | alUl=10 Maly em elelel> 
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Access API Programmer's Reference 


Mv} ii Kommore]a)iiale(=re 


/* Start the API Interface using Service OOH. This lets us know if Access 
API is loaded. */ 


registers.x.ax = START; 
res = int86x (int_value, &registers, &registers, &sgregs ); 
if ( registers.h.al != SUCCESS ) 

return (1); 


/* Double check to confirm we are indeed talking to Access through the in- | 
terrupt. To do this we check the session status of an invalid session and 
verify the result. */ 


registers.x.ax = SESSION_ STAT; 
registers.x.bx =-1; /* Invalid session id */ 
registers.x.di = bufstat; 
sgregs.es = sgregs.ds; 
res = int86x (int_value, &registers, &registers, &sgregs ); 
if ( registers.h.al == INVAL_ID ) 
return(0); 
else 
return(1 ); 
} | 
[RRA RR IIIIIIIIIIIII IRR IIIEKII IISA ISIE AS ASIII IRI RII IKI ISSA IIIAIRISIIAAR EIR 
/* set_interrupt : This function strips the /interrupt flag and correspond- 
ing hex value from the command line. If the hex value is legal, then the 
global variable int_value is set. This ensures that all API function calls 
will use the proper software interrupt. 
* 
/ 
set_interrupt (argc_p, argv_p) 


int *argc_p; 
char **argv_p]]; 


{ 

char **parm; 

int i; 

int_value = INT_NB; 

if (*argc_p <2) 
return; 

parm = *argv_p; 

if (strlen( *( parm+1)) <4) 
return; 

if ( strncmp( *( parm+1 ),"/l=",3 ) ) 
if (strncmp ( *(parm+1),"/i=",3 ) ) 

return; 

i = hex_value( *( parm+1 )+2 ); 

if (i == NOT_HEX) 
return; 

if (i<Ox40 ) 
return; 

(*argc_p )--; 

(*argv_p)++; 

int_value = i; 

return; 


continued next page | 
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“ 


/* ret_current_id: Returns the Session ID of the current foreground ses- 


sion. 

+ 

intret_current_id() 

{ 
char rc, bufstat[65]; 
int res, |; 
union REGS registers; 
struct SREGS sgregs; 
segread( &sgregs ); 


sgregs.es =sgregs.ds; 


/* Use Service 11: Query Status to find the current foreground session. 
Register CL will be 1 if session is in foreground. Since Access supports 
up to nine concurrent sessions we must loop, checking each one in suc- 
cession */ | 


/* end_api : 


for ( i=1; i; i++ ) 

{ 
registers.x.ax = SESSION_STAT; 
registers.x.di = bufstat; 
registers.x.bx = i; 


res = int86x ( int_value, &registers, &registers, &sgregs ); 


if ( (registers.h.al == SUCCESS) && (registers.h.cl == 1)) /* found it */ 


return(i); 


return(0);/* no foreground session */ 


char end_api() 


{ 


} 


int res; 
union REGS registers; 


registers.x.ax = END; 
res = int86( int_value, &registers, &registers ); 


This function closes the API Interface using Service 14H. 


if 


/ 2 


[ER RAA HARIRI IATA IRIAN II RII IIA RIKI AR IASI ISIN IIIAIA TASS IAAI ARIANA EAN IARTEN | 
/* set_fg: This function places the session with sessid into the 
foreground.*/ 


int set_fg( sessid ) 
int sessid; 


{ 


int res; 
union REGS registers; 


registers.x.ax = CSET FG; 
registers.x.bx = sessid; 
res = int86( int_value, &registers, &registers ); 


‘continued next page | . 
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/* hex_value : This function returns the integer value of a two-digit 
hexadecimal number (code). The format of code is a slash followed by 
two ascii characters. 


*/ 


int hex_value( code ) 
char *code; 


{ 


int i, value = 0; 
char C; 


code++; /* advance to ignore the slash */ 
for ( i=0; i; i++ ) 


c = code{i]; 

if(c==0) 
return( value ); 

value = value < 4; 

if ( (C>=’a’) && (c <=’f’) ) 
value += (c -’a’ ) + Ox0a; 

else 

if ( (c>=’A’) && (c<=’F’) ) 
value += (c - A’) + 0x0a; 

else 

if ( (C>="0’) && (c<=’9’) ) 
value += (c-’0’); 

else 

return( NOT HEX); / not a hex value */ 


return( value ); 


~ end of "utils.c" | 
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sample Programs 


The following is the source code for the ANSWER Executable DOS 
file. | 


/* answer.c Copyright (c) Eicon Technology Corp. 1988 


Description: This program initiates a 3270, 5250 or ITI call. The call 
name must exist in the Access calling directory. This program returns 
without waiting for the call to complete. The WAIT program should be 
used to determine if the call has connected. 


Usage: ANSWER call name. 
“t 

#include <dos.h> 

#include <stdio.h> 

#include “api.h" 

extern unsigned char int_value; 
main( argc, argv ) 

int argc; 

char *argv{]; 


{ 
char rc, start_api(), end_api(); 
int res; 
union REGS registers; 
struct SREGSsgregs; 


set_interrupt (&argc, &argv); 
if (argc != 2) 


puts("*** Invalid number of parameters"); 
exit( INVAL_PARM ); 


rc = Start_api(); 
if (rc != SUCCESS ) 
{ 


puts("*** API] system not loaded"); 
exit( APL NOT_RES ); 
} 


registers .x.cx = strlen( argv[1] ); 
registers.x.di = argv[1]; 
registers.x.ax = CANSWER; 
segread( &sgregs ); 

sgregs.es = sgregs.ds; 


res = int86x (int_value, &registers, &registers, &sgregs ); 


erolaniiaielstomalsyancreletem | 
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if ( registers.h.al != SUCCESS ) 
{ 


rc=end_api(); 
if (registers.h.al == 0x01 ) 

puts("*** Calling directory name not founda"); 
if ( registers.h.al == 0x02 ) 

puts("*** Answer unsuccessfull") 


eyit! ranicterc h al \- 
En eg core a 


} 


rc = set_fg( registers.x.bx ); /* put the session into the foreground */ 


re = end_api(); | 


The most effective way to make use of the Executable DOS Files is 
in batch files. Through the use of the ERRORLEVEL variable it is 
possible to construct some fairly sophisticated batch files to 
automate repetitive tasks. 


When you are testing ERRORLEVEL values make sure that you start 
with the highest value and work your way down. The IF expression 
will be true if ERRORLEVEL is equal to or less than the test value. 


sample Batch File #1 


Batch File Entry Notes 


getstat Determine Access program type 


if errorlevel = 106 goto SDLC Test for match in decending order 


if errorlevel = 102 goto QLLC 


if errorlevel = 101 goto X25 


if errorlevel = 11 goto quit API not resident so quit. 
*X25 
echo Access/X.25 


goto quit 
:QLLC 
echo Access/QLLC 
goto quit 
“SDLC 
echo Access/SDLC 
:quit 


Batch Files 
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The following is an example of a batch file that could be used by a 
branch office to exchange daily reports with its head office. 


sample Batch File # 2 


Batch File Entry 
echo off 
answer HEADOFFICE 


if errorlevel = 1 goto end 
wait ANSWER 30 
if errorlevel = 1 goto end 


match "User name?" 

if errorlevel = 1 goto stop 
wait MATCH 30 

if errorlevel = 1 goto stop 


type "Office25" /CR 


if errorlevel = 1 goto stop 
capture "c:\report" 

if errorlevel 1 goto stop 
match "Report Sent’ 

if errorlevel = 1 goto stop 
wait MATCH 120 


if errorlevel = 1 goto stop 
send "c:\news.txt" 

if errorlevel = 1 goto stop 
wait SEND 

stop: 

hangup 


end: 


Notes 


Setup to receive a call from the Head Of- 
fice 


Any value >= 1 indicates an error condi- 
tion, so exit 


Wait 30 seconds maximum for call to con- 
nect 


Any value >= 1 indicates an error condi- 
tion, So exit 


Look for the prompt 
Wait 30 seconds for the prompt 


Respond to the prompt with a user name 
plus a carriage return 


Enable capture of data to a file 
Look for confirmation 


Wait 120 seconds maximum for file trans- 
fer to complete and confirmation to be 
displayed 


Send a file to Head Office 
Wait for the send to be completed 


An error occured once the connection was 
established so hang it up before quitting. 


Return to DOS 


aera 
Stay 


A 


ppendix D: 
Reference Books 


The following manuals are related to the operation and use of E/CON 
different versions of the Access application program. The manuals 
are available from Eicon Technology or any of its representatives. 


= 


Pa 


=> 


=> 


=> 


Access /X.25 User’s Guide (200-100-3) 

Access/QLLC 3Z70 Support User's Guide (ZO0U- 143-1) 
Access/QLLC 5250 Support User’s Guide (200-126-1) 
Access/SDLC 3270 Support User’s Guide (200- 108-2) 


Access/SDLC 5250 Support User's Guide (200-129-1) 


The following is a list of reference books related to IBM software and 
hardware products: 


5250 Communications 


=> 


IBM 3251 Display Station Models 2 and 12 Operators Guide 
(GA21-9323) 


IBM 5251 Display Station Models 1 and 11 Operator’s Guide 
(GA21-9248) 


IBM 5291 Models 1 and 2 Display Station User’s Guide (GA21- 
9409) 


IBM 5292 Color Display Station Operator’s Guide (GA21-9416) 


System Network Architecture Concepts and Products (GC30- 
3072-2) 


IBM 5250 Information Display System Functions Reference 
Manual (SA21-9247) 


PC Support/36 User's Guide (SC21-9088-2) 
PC Support/38 User’s Guide (SC21-9089-1) 


Technology 


IBM 
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3270 Communications 


= IBM 3270 Information Display System: 3274 Control Unit 
Operator’s Guide (GA23-0023) 


z+ IBM 3270 Information Display System 3278 Display Station 
Operator’s Guide (GA27-2890-3) 


2+ IBM PC 3270 Emulation Program User’s Guide (59X995 1) 


x IBM PC 3270 Emulation Program Application Programming In- 
terface and Host Reference (59X9971) 


z+ IBM 3287 Printer Operator’s Guide (GA27-3147) 


The X.25 Standards referred to in this manual are defined in various 
sections of Volume 8 of the CCITT Red Book, Malaga-Torremolinos 
1984: 


z+ Volume VIII, Fascicle VIII.2 contains Recommendation X.3 


=+ Volume VIII, Fascicle VII.3 contains Recommendations X.25, 
X.28, X.29 


=> Volume VIII, Fascicle VIII.4 contains Recommendation X.12] 
All these publications are available from: 


United Nations Bookstore 
Room GA 32B 
New York, NY 10017 
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LIMITED WARRANTY 


Eicon Technology warrants the media on which the program is furnished to be free from defects in materials | 


and workmanship under normal use for a period of ninety (90) days from the date of delivery to you as 
evidenced by a copy of your receipt. 


THE PROGRAM IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR 
IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK TO THE QUALITY AND PERFORMANCE OF 
THE PROGRAMS IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU (AND NOT EICON 
TECHNOLOGY) ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING REPAIR OR CORRECTION. 


SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE 
EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS AND YOU 
MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM ONE JURISDICTION TO ANOTHER. 


Eicon Technology does not warrant that the functions contained in the program will meet your requirements 
or that the operation of the program will be uninterrupted or error free. However, Eicon Technology warrants 
the media on which the program is furnished, to be free from defects in materials and workmanship under 


normal use for a period of ninety (90) days from the date of delivery to you as evidenced by a copy of your 
receipt. 


EICON TECHNOLOGY SOFTWARE LICENSE AGREEMENT 


YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE OPENING THE 
DISKETTE PACKAGE. OPENING THE DISKETTE PACKAGE INDICATES YOUR ACCEPTANCE OF THESE 
TERMS AND CONDITIONS. IF YOU DO NOT AGREE WITH THEM, YOU SHOULD PROMPTLY RETURN THE 
PACKAGE UNOPENED AND YOUR MONEY WILL BE REFUNDED. 


Title to the media on which program is recorded and to documentation in support thereof is transferred to 
you, but the title to the program is retained by Eicon Technology Corporation. You assume responsibility for 
the selection of the program to achieve your intended results, and for the installation, use, and results 
obtained from the program. 


License 


Under the terms and conditions of this License Agreement you may: 

e use the program on a single machine; 

* copy the program into any machine readable or printed form for backup or modification purposes in 
support of your use of the program on the single machine; (certain programs however may include 
mechanisms to limit or inhibit copying; they are marked copy protected;) copying of documentation 
and other printed material is prohibited; 

¢ modify the program and/or merge it into another program for your use on the single machine; (any 
portion of this program merged into another program will continue to be subject to the terms and 
conditions of this Agreement;) 

¢ transfer the program and license to another party if the other party agrees to accept the terms and 
conditions of this Agreement. If you transfer the program you must at the same time either transfer all 
copies whether in printed or machine readable form to the same party or destroy any copies not 
transferred; this includes all modifications and portions of the program contained in or merged into 
other programs. 

You must reproduce and include the copyright notice on any copy, modification or portion merged into 
another program. 


You may not use, copy, modify, or transfer the program, or any copy, modification or merged portion, in 
whole or in part, except as expressly provided for in this License Agreement. 


If you transfer possession of any copy, modification or merged portion of the program to another party, your 
license is automatically terminated. 
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Term 

The license is effective until terminated. You may terminate it at any time by destroying the program together 
with all copies, modifications and merged portions in any form. It will also terminate upon conditions set 
forth elsewhere in this Agreement or if you fail to comply with any term or condition of this Agreement. You 


agree upon such termination to destroy the program together with all copies, modifications and merged 
portions in any form. 


Limitations of Remedies 


a Technology's entire liability and your exclusive remedy shall be: 
with respect to defective media during the warranty period Eicon Technology will replace media not 
meeting Eicon Technology's Limited Warranty if returned to Eicon Technology or its authorized 
representative with a copy of your receipt, or 
° if Eicon Technology or its representative is unable to deliver replacement media free of defects in 
materials and workmanship, you may terminate the Agreement by returning the program and your 
money will be refunded. 
IN NO EVENT WILL EICON TECHNOLOGY BE LIABLE FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, 
LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR 
INABILITY TO USE SUCH PROGRAM EVEN IF EICON TECHNOLOGY OR ITS AUTHORIZED REPRE- 
SENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR ANY CLAIM BY ANY 
OTHER PARTY. 


SOME JURISDICTIONS DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL 
OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. 


General 


You may not sublicense, assign or transfer the license or the program except as expressly provided in this 
Agreement. Any attempt otherwise to sublicense, assign or transfer any of the rights, duties or obligations 
hereunder is void. 


This Agreement is governed by the laws of the Province of Quebec, Canada. 


The parties agree that this Agreement be written in English. Les partis consentent a ce que cette entente soit 
rédigée en anglais. 


Should you have any questions concerning this Agreement, you may contact Eicon Technology in writing at 
2196 32nd Avenue, Montreal, Canada H8T 3H7. 


YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT, UNDERSTAND IT AND AGREE TO BE 
BOUND BY ITS TERMS AND CONDITIONS. YOU FURTHER AGREE THAT IT IS THE COMPLETE AND 
EXCLUSIVE STATEMENT OF THE AGREEMENT BETWEEN US WHICH SUPERSEDES ANY PROPOSAL OR 
PRIOR AGREEMENT, ORAL OR WRITTEN, AND ANY OTHER COMMUNICATIONS BETWEEN US RELATING 
TO THE SUBJECT MATTER OF THIS AGREEMENT. 


Product Comment Form 


Access AP/ Programmer’s Reference (200-124-2) 


We would appreciate your comments regarding any problems en- Your Comments 
countered while using this or any other Eicon Technology product. 
Please use this form to let us know about your concerns. are Welcome 


Name: Submilfter 
Title: 


Company: 
Address: 


Comments 


Eicon Technology can be reached by phone, telex, fax and mailat. ReaCN Us Af 


Eicon Technology 
2196 - 32nd Avenue (Lachine) 
Montreal, Quebec 
Canada H8T 3H7 


Phone: 514-631-2592 
Fax: 514-631-3092 
Telex:  0O5-25134-MTL 
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